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写 在 前 面 


你 好 ， 我 是 里 克 ，2007 年 开始 从 事 Rails 开发 工作 。《Rails 实践 》 这 本 书 ， 是 我 第 一 次 编写 
完整 的 教程 ， 对 我 来 说 ， 它 更 像 是 对 过 往 经 验 的 总 结 。 


本 书 通过 一 个 在 线 网 店 程序 的 开发 过 程 ， 带 领 大 家 了 解 Rails 全 貌 。 第 一 章 ， 我 们 安装 Ruby 
和 Rails 的 开发 环境 ， 并 学 习 如 何 设计 项 目 UI。 第 二 章 ， 我 们 讲解 Rails 中 的 资源 含义 ， 学 习 
Rails 如 何 实现 REST 风格 架构 ， 感 受 Rails 的 快捷 开发 。 第 三 章 ， 我 们 关注 Rails 的 视图 ， 

从 页 面部 分 开始 了 解 MVC 框架 。 第 四 章 ， 我 们 关注 数据 库 部 分 ， 讲 解 Rails 中 的 M。 第 五 

章 ， 我 们 在 了 解 控制 器 的 同时 ， 完 成 我 们 网 店 的 购买 功能 。 第 六 章 ， 我 们 学 习 Rails 中 的 各 种 
配置 ， 并 将 它 在 云 服 务 器 上 部 署 运行 。 


在 阅读 本 书 同时 ， 也 希望 你 能 阅读 其 他 Ruby fe Rails 的 教程 ， 博 客 和 新 闻 ， 增 加 知识 储备 。 


写 出 正确 的 代码 是 需要 理由 的 。 


阅读 电子 版 


本 书 电子 版 为 免费 阅读 ， 目 前 有 两 个 指定 的 发 布地 址 : 
独立 域名 : http://rails-practice.com/ 


极 客 学 院 wiki : http://wiki.jikexueyuan.com/project/rails-practice/ 


当前 版 本 


1.1.0 


2017 年 2 月 更 新 说 明 


o 书 名 更 新 为 《Rails 实践 : 使 用 Rails 4 构建 在 线 网 店 》 

© 使 用 Docker 作为 开发 调试 环境 ， 增 加 了 README.md， 针 对 每 一 份 代 码 有 如 何 创建 容 
器 的 说 明 

e Ruby 版 本 更 新 为 2.3.3， 请 使 用 docker pull ruby:2.3.3 镜像 创建 容器 

e Rails 版 本 统一 更 新 为 4.2.7.1， 请 使 用 bundle update rails 升级 当前 版 本 

调整 项 目 代 码 在 当前 Ruby 和 Rails 版 本 下 可 正常 运行 

更 新 gems 数据 源 为 https://gems.ruby-china.org 

e 去 掉 了 .ruby-version 和 .ruby-gemset 两 个 文件 


告 合 大 家 在 issue 中 反馈 的 问题 进行 调整 
E 


本 书 读者 


本 书 适合 期 望 使 用 Rails 制作 Web 网 站 的 开发 者 ， 读 者 需要 具备 基础 的 HTML，JS 和 CSS 
知识 ， 并 且 了 解 Ruby 基本 语法 。 你 可 以 从 未 使 用 过 Ruby 和 Rails， 这 没关系 ， 本 书 会 带领 
你 从 安装 Ruby 环境 开始 ， 直 到 完成 这 个 Rails 项 目 。 


在 学 习 的 过 程 中 ， 我 建议 读者 注册 一 个 github.com 账号 ， 建 立 一 个 学 习 笔 记 的 代码 仓库 
(Repo) 中 。 


本 书 约 定 


。 名词 首 字母 大 写 。 

e 关 文 缩写 大 写 。 

e 命令 小 写 。 

e 作为 名 词 时 ， 首 字母 大 写 ， 作 为 命令 时 NG o Rails > Ruby 同 。 

e 专 有 名 词 不 翻译 。 

e 专 有 名 词 按照 约定 书写 ， 如 iPhone，iMac，html，js，css，php，jQuery 等 等 。 
e 中 文 和 英文 间 留 有 空格 。 

e 命令 行 中 ， 当 前 用 户 操作 使 用 % 开头 ，root 用 户 操作 ， 用 $ 开头 。 


版 权 声 明 


本 书 的 著作 权 归 作者 李 玮 ( 署 名 : 里 克 ) 所 有 。 

你 可 以 : 

e 下载、 保存 以 及 打印 本 书 

e 网 络 链接 、 转 载 本 书 的 部 分 或 者 全 部 内 容 ， 但 是 必须 在 明显 处 提供 读者 访问 本 书 发 布 网 
站 的 链接 

o 在 你 的 程序 中 任意 使 用 本 书 所 附 的 程序 代码 ， 但 是 由 本 书 的 程序 所 引起 的 任何 问题 ， 作 
者 不 承担 任何 责任 

你 不 可 以 : 


e. 以 任何 形式 出 售 本 书 的 电子 版 或 者 打印 版 
e 擅自 印刷 、 出 版 本 书 


e 以 纸 媒 出 版 为 目的 ， 改 写 、 改 编 以 及 摘抄 本 书 的 内 容 


读者 反馈 


你 可 以 在 https://github.com/liwei78/rails-practice/issues 页 面 写 下 你 的 问题 ， 也 可 以 留 下 意见 
和 建议 。 


示例 代码 


https://github.com/liwei78/rails-practice-code 


你 可 以 fork 这 份 代码 到 自己 的 代码 仓库 (Repo) 中 ， 人 和 修改 并 提交 ， 然 后 向 我 的 代码 仓库 提 
X Pull Request ， 如 果 修 改 无 异议 ， 我 将 合并 到 master 中 。 


作者 介绍 


李 玮 ， 网 名 里 克 ，2007 年 开始 从 事 Rails 开发 ， 先 后 经 历 过 社会 化 搜索 引擎 deyeb， 华 为 生 
活 社区 百草 网 ， 电 商 平台 等 开发 工作 。 在 某 网 络 安全 公司 从 事 产品 开发 。 


工作 之 余 ， 担 任 长 春 心 语 志 愿 者 协会 网 络 顾 问 ， 编 程 教练 以 及 80 学 院 Rails 导师 。 


里 克 的 自习 室 公众 号 
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第 一 章 Ruby on Rails 概述 


课程 概要 : 


本 课程 主要 讲解 Ruby on Rails 基 础 知识 ， 包 括 对 Rails 开发 环境 、Ruby 版 本 及 Ruby 管理 工 
A RVM 的 简单 介绍 ，Rails 项 目 中 的 文件 含义 的 讲解 ， 并 为 即将 开始 的 Rails 项 目 设计 用 户 
Rm (Ul) ° 
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1. Rails 开发 环境 概述 
2. Rails 中 的 文件 概述 
3. APR (Ul) 设计 


课程 背景 


Ruby 是 一 门 现代 ， 面 向 对 象 的 脚本 语言 。 它 简洁 、 容 易 理 解 ， 可 以 让 你 快速 地 用 代码 自然 、 
清晰 表达 想法 。 让 你 的 程序 能 很 简单 被 编写 并 且 在 几 个 月 后 还 能 很 容易 读 懂 。Ruby on Rails 
是 一 个 Web 应 用 程序 框架 ,是 一 个 相对 较 新 的 Web 应 用 程序 框架 ， 构 建 在 Ruby 语言 之 上 。 
它 被 宣传 为 现 有 企业 框架 的 一 个 替代 ， 而 它 的 目标 ， 简 而 言 之 ， 就 是 让 生活 ， 至 少 是 Web 开 
发 方面 的 生活 ， 变 得 更 轻松 。 通 过 本 课程 的 学 习 ， 学 员 能 够 掌握 如 何 搭建 开发 环境 ， 了 解 
Rails 项 目 中 文件 的 含义 ， 并 通过 用 户 界面 (UI1) 的 设计 ， 了 解 项 目 如 何 交 付 ， 以 及 要 实现 的 
目标 。 


1.1 Ruby on Rails 开发 环境 介绍 


概要 : 


本 课时 介绍 了 Ruby 及 Rails 的 开发 环境 ，RVM 和 Ruby 的 安装 ， 以 及 操作 系统 平台 的 选 


择 。 


Rails 安装 
代码 管理 


wn > 


Ex 
1.1.1 Ruby 简介 


Ruby, 是 由 松本 行 弘 先生 在 1995 年 正式 发 布 的 一 种 “面向 对 象 编程 "的 脚本 语言 。 推 荐 两 本 松 
本 行 弘 的 书籍 。 
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编程 语言 
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再 推荐 大 家 几 本 Ruby 开发 给 


封面 





书评 


《松本 行 弘 的 程序 世界 》 是 探索 
程序 设计 思想 和 方法 的 经 典 之 
作 。 作 者 从 全 局 的 角度 ， 利 用 大 
量 的 程序 示例 及 图 表 ， 深 刻 阅 述 
了 Ruby 编 程 语言 的 设计 理念 ， 并 
以 独特 的 视角 考察 了 与 编程 相关 
的 各 种 技术 。 


《代码 的 未 来 》 是 Ruby 之 父 松 本 
行 弘 的 又 一 力作 。 作 者 对 云 计 

算 、 大 数据 时 代 下 的 各 种 编程 语 
言 以 及 相关 技术 进行 了 剖析 ， 并 
对 编程 语言 的 未 来 发 展 趋势 做 出 
预测 ， 内 容 涉 及 Go、VoltDB、 
node.js ` CoffeeScript ` Dart ` 
MongoDB、 摩 尔 定律 、 编 程 语 
言 、 多 核 、NoSQL 等 当今 备 受 关 
注 的 话题 。 


|o ZR AXE Rails 之 余 ， 更 多 的 了 解 Ruby。 


书 名 


The 
Pragmatk For Ruby 1.9 
IC ines m" Ruby 20 
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Ruby 元 编程 


Metaprogramming Ruby 


Program 
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Ruby 编程 


Ruby 元 编程 


Ruby on Rails 开发 环境 介绍 


(Co annaditan 
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Seven Languages in Seven Weeks 
A Pragmatic Guide to Learning Programming Languages 


七 周 七 语言 
理解 多 种 编程 范 型 
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&i 2011 年 Jolt 大 奖 图 节 
© 带 媒 轻松 入 门 蕊 种 先锋 话 言 
S FARE. SP SUE 


f Atina 


更 多 Ruby 的 介绍 ， 大 家 可 以 查看 Ruby 简介 和 207-47 4 36 Ruby e 


1.1.2 Rails 简介 


我 们 使 用 的 Rails， 就 是 基于 Ruby 开发 的 。Rails 的 完整 称呼 是 Ruby on Rails， 简 称 Rails > 
是 由 丹麦 人 David Heinemeier Hansson (DHH) 在 2003 年 发 布 的 开源 Web 框架 。 
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图 为 穿着 赛车 服 的 DHH， 他 和 其 他 两 队友 获得 了 2014 年 勒 芒 24 小 时 耐力 赛 GTE-Am 组 的 冠 
Yo 

Rails 是 一 个 基于 MVC 模式 的 高 效 的 开发 框架 。 在 我 刚刚 接触 Rails 的 2007 年 ， 很 多 人 说 不 
需要 了 解 Ruby， 就 可 以 使 用 Rails 开发 网 站 了 ， 足 见 Rails 的 方便 和 快捷 。 而 快速 开发 ， 也 
RAT Rails 迅速 获得 众多 开发 人 员 喜 爱 的 原因 ， 众 多 大 型 网 站 ， 曾 经 或 现在 ， 正 在 使 用 着 
Rails 。Rails 的 受 欢迎 ， 也 使 得 Ruby 跻身 最 流行 的 开发 语言 排名 前 列 。 


注 : 勒 芒 大 赛 对 车 手 是 个 极 大 的 考验 ，FISA 规 定 勒 芒 每 部 赛车 由 3 名 赛 手 分 别 驾驶 (1980 年 中 
期 以 前 为 2 名 赛 手 )， 即 采用 换 人 不 换 车 的 方法 ， 所 有 的 加 油 、 换 胎 和 维修 时 间 都 包括 在 24 小 
时 以 内 。 最 后 ， 行 驶 里 程 最 多 的 赛车 获胜 ， 一 般 一 屋 夜 下 来 ， 成 绩 最 好 的 赛车 行驶 的 里 程 将 

近 5000 公 里 。 每 人 连续 驾驶 时 间 不 超过 4 小 时 ， 主 车 手 总 驾驶 时 间 不 超过 14 小 时 。 勒 芒 环 行 跑 
道 全 长 13 公 里 ， 其 中 绝 大 部 分 是 封闭 式 的 公用 高 速 公路 ， 赛 车 在 其 2/3 的 路 段 上 时 速达 
370km/h 左 右 ，C 组 车 一 般 只 用 3 分 钟 左右 的 时 间 就 能 跑 完 一 圈 的 路 程 。 在 跑道 上 有 一 段 约 
6km 的 直路 ， 赛 车 在 这 段 路 上 飞速 驶 过 ， 速 度 达 到 390km/h。 


1.1.3 Ruby 安装 
在 安装 Rails 前 ， 我 们 先 来 安装 Ruby 环境 。 这 里 ， 我 们 使 用 rvm 这 个 工具 。 


注 : 以 下 安装 及 后 续 开发 是 在 Mac 系统 上 进行 的 ，Windows 系统 可 以 选择 rubyinstaller ° 42 
是 在 windows 开发 Rails 程序 会 遇 到 众多 问题 ， 建 议 大 家 安装 虚拟 机 或 者 Linux 双 系 统 进行 
开发 。 


RVM X Ruby 管理 工具 ， 可 以 方便 的 安装 、 管 理 、 切 换 多 个 Ruby， 管 理 Gemset 。 


安装 RVM 的 命令 是 : 
curl -SSL https://get.rvm.io | bash -s stable 

如 果 你 已 经 安装 了 RVM， 可 以 用 这 个 命令 升级 到 最 新 的 stable 版 本 : 
rvm get stable 


在 有 的 操作 系统 中 ， 会 给 出 这 个 提示 : 


* To start using RVM you need to run “source /home/webmaster/.rvm/scripts/rvm^ 
in all your open shell windows, in rare cases you need to reopen all shell windows 


这 是 你 可 以 运 行 提 T 中 的 命令 3 source /home/webmaster/.rvm/scripts/rvm ， 或 者 退出 EE NG 


i shell， 再 次 登入 。 


我 们 在 当前 开发 用 户 中 安装 RVM， 不 必 切 换 到 root 用 户 下 。 在 生产 服务 器 (Poduction) 
中 ， 可 以 使 用 专门 的 项 目 管理 用 户 ， 并 具备 sudo 权限 。 我 们 在 后 面部 署 章节 里 会 详细 介绍 。 


安装 完 RVM 后 
以 查看 可 安装 的 Ruby 版 本 : 


% rvm 


[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 
[ruby- 


list 
]1. 
]1. 
]1. 
]1. 
]1. 
]2. 
]2. 
]2. 
]2. 
]2. 
ruby-head 


， 我 们 可 以 使 用 rvm -v 查看 版 本 。 我 们 使 用 rvm list known 这 个 命令 


known 


.6[ -p420] 


.7[-head] # security released on head 


.2[-p330] 
.3[-p551] 
0.0[-p598] 


1.4 
1[.5] 
2.0 
2-head 


8 
8 
9.1[-p431] 
9 
9 


我 们 的 课程 里 ， 将 使 用 2.2.0 这 个 版 本 : 


rvm install 2.2.0 


我 们 可 以 查看 当前 安装 


96 rvm list 
-* ruby-2.2.0 [ x86 64 ] 


如 果 你 已 经 安装 了 其 他 版 本 的 Ruby » "TX 


Ruby 版 本 : 


rvm use 2.2.0 


的 Ruby 版 本 : 


- default 


看 一 下 我 们 的 Ruby 版 本 : 


% ruby -V 


--default 参数 ， 设 置 RVM 默认 使 用 的 


ruby 2.2.0p0 (2014-12-25 revision 49005) [x86 64-darwin13] 


1.1.4 Rails 安装 


UT 


安装 Rails 前 ， 我 们 先 创建 一 个 Gemset » Gemset 是 一 个 独立 的 Gem 集合 ， 可 以 为 每 个 项 


目 设 置 自 己 的 Gemset， 而 不 会 相互 干扰 。 


rvm gemset create rails4.2 
rvm use 2.2.0@rails4.2 --default 
gem install rails -v 4.2.0 --no-document 
it: --no-document 会 跳 过 安装 fi 和 rdoc 文档 ， 可 以 减少 安装 时 间 。 


注 : 在 一 些 系 统 环境 中 ， 还 需要 先 安 装 bundler， 它 的 命令 是 gem install bundler ° Bundler 
是 Ruby 跟踪 和 安装 Gem 的 工具 ， 它 的 官网 在 这 里 http:/bundler.io/ 。 


在 后 面 代码 开发 中 ， 我 们 将 继续 使 用 Ruby 2.2 和 Rails 4.2 版 本 。 


这 里 有 一 份 RVM 实 用 指南 供 大 家 参考 。 


1.1.5 操作 系统 


Ruby 和 Rails 的 开发 环境 ， 可 以 在 多 个 操作 系统 上 安装 ， 你 可 以 选择 Mac 作为 开发 平台 ， 也 
可 以 使 用 Ubuntu 等 linux 系统 ， 作 为 开发 和 生产 环境 部 署 平台 。windows 系统 可 以 作为 开发 
平台 使 用 。 


1.1.5 代码 管理 


在 正式 进入 我 们 的 教学 前 ， 请 先 熟悉 一 下 git 的 简单 操作 (中文 版 )，Git 是 一 个 开源 的 分 布 式 
版 本 控制 系统 ， 用 以 有 效 、 高 速 的 处 理 从 很 小 到 非常 大 的 项 目 版 本 管理 。 


我 们 的 代码 是 放 到 github 上 的 ， 你 可 以 clone 下 来 我 们 的 代码 ， 在 本 地 调试 。 另 外 ， 你 也 需 
要 准备 好 自己 的 编辑 器 。 


github 是 一 个 打开 托管 平台 ， 也 是 一 个 开发 者 的 互动 社区 ， 你 可 以 在 上 面 阅读 大 量 的 开源 代 
码 ， 比 如 Ruby，Rails， 还 有 我 们 每 一 个 章节 的 代码 。 


墙 裂 建议 你 注册 一 个 github 的 账号 ， 把 你 学 习 的 代码 和 经 验 总 结 放 到 上 面 去 。 代 码 可 以 创建 
代码 仓库 (repo) ， 学 习 经 验 可 以 创建 github 的 wiki 页 面 ， 或 者 使 用 markdown 来 编写 。 对 
于 一 些 实用 的 代码 片段 ， 可 以 使 用 gist 保存 。 


阅读 


我 推荐 大 家 阅读 Rails 入 门 介绍 ， 它 的 中 文 内 容 在 这 里 。 


1.2 Rails 文件 简介 


概要 : 


本 课时 介绍 Rails 项 目 创建 后 的 文件 含义 ， 介 绍 Rails 项 目 中 的 三 种 运行 环境 ，Gemifile 及 
Gem， 以 及 Rake 任务 等 。 


án ps AMA] 。 


文件 含义 

运行 环境 说 明 及 配置 
Gem 和 Gemfile 
Rake 任务 


R O Po > 


EXT 
1.2.4 基础 文件 介绍 
本 节 开 始 前 ， 我 们 先 使 用 一 个 命令 ， 创 建 Rails 项 目 。 或 许 你 已 经 知道 了 ， 它 就 是 : 


rails new shop 


提示 : 如 果 你 已 经 安装 了 其 他 版 本 的 Rails > MLATA MARAMARA ER > wR 
其 他 版 本 ， 可 以 这 样 来 写 


rails 4.1.5 new shop 


如 果 你 想 查看 已 经 安装 的 Rails 有 哪些 版 本 ， 可 以 使 用 gem list | grep rails 。 


好 了 ， 我 们 来 看 一 下 new 为 我 们 创建 了 哪些 文件 。 


app 文件 夹 


我 们 的 业务 逻辑 文件 存放 地 ， 在 后 面 的 教程 里 ， 我 们 会 经 常 为 它 增 加 内 容 ， 到 时 会 详 加 介 


绍 。 


config 文件 夹 


Rails 的 配置 文件 。 首 先 ， 打开 environments 文件 来， 我 们 可 以 看 到 三 个 文 
件 ， 这 分 别 对 应 Rails 的 三 种 运行 环境 ， 我 们 开始 时 候 使 用 的 是 development 环境 ， 运 行 测 
Ael test 环境 ， 当 我 们 把 代码 部 署 到 服务 器 上 ， 正 式 上 线 的 时 候 ， 使 用 的 是 production 环 
境 。 


Rails 允许 我 们 分 别 为 三 种 环境 做 不 同 的 设置 ， 比 如 ，production 中 config.assets.digest = 
true ? 而 开发 环境 可 以 设 为 config.assets.digest = false ? 


Rails 还 为 我 们 提供 了 118n 的 管理 功能 ， 这 里 还 只 有 en. o 一 种 语言 包 ， 后 面 的 课程 里 ， 我 
们 将 详细 介绍 118n 功能 ， 并 添加 简体 中 文 和 美文 语言 包 。 


database.yml 中 配置 了 数据 库 信 息 。Rails 默认 使 用 sqlite 数据 库 作 为 开发 使 用 。 我 们 也 可 以 
更 改 它 ， 在 new 的 时 候 这 文 样 做 : rails new shop -d mysql|oracle|postgresql|... 


routes.rb 是 我 们 的 路 由 文件 ， 一 个 非常 重要 的 文件 ， 我 们 下 一 个 章节 将 从 它 开 始 介绍 Rails 
的 诸多 优秀 设计 。 


secrets.yml 中 的 配置 分 别 对 应 三 种 运行 环境 ， 它 是 用 来 加 密 我 们 的 session 的 。 


db 文件 夹 


如 果 你 使 用 的 是 sqlite 数据 库 ， 那 么 你 会 发 现 它 存放 在 这 里 。sqlite 是 一 种 小 型 的 便于 开发 环 
境 使 用 的 数据 库 。 在 生产 环境 (production) 的 数据 库 ， 比 如 mysql’ postgres 等 数据 库 文 
件 ， 是 不 需要 放 到 这 里 的 。 


migrate 文件 夹 中 ， 存 放 的 是 我 们 的 数据 库 迁 移 文 件 ， 下 一 章 我 们 会 经 常 看 到 它 。 


这 里 还 有 一 个 seeds.rb 文件 ， 可 以 用 它 来 为 项 目 创建 一 些 初始 数据 。 


lib TAX 


lib， 在 我 们 开发 Rails 项 目 是 ， 会 经 常 的 扩展 一 些 功能 ， 些 功能 具有 复 用 的 特点 时 ， 可 以 
把 代码 放 到 lib 中 。 


这 里 我 想到 了 Rails 的 一 条 哲理 : Convention Over Gannguratah ， 约定 优 于 配置 。 我 们 扩展 
的 功能 文件 ， 可 以 放 到 任何 可 被 夹 在 的 目录 下 ， 但 是 ， 那 违背 了 Rails 的 这 条 哲理 。 
log 文件 夹 


这 里 存放 的 是 日 志文 件 ， 我 们 可 以 看 到 它 对 应 了 上 面 的 三 种 运行 环境 ，Rails 把 每 一 种 运行 环 
境 的 log， 都 单独 的 存放 。 


public 文件 夹 


这 里 存放 的 是 静态 文件 ， 比 如 图 片 ，html， 还 有 编译 好 的 js，css 等 。 


test 


这 里 是 测试 文件 ， 我 们 编写 项 目的 同时 ， 也 会 带领 大 家 编写 对 应 的 测试 代码 。 所 以 我 们 后 面 
会 经 常 的 用 到 它 。 


， 我 们 使 用 Rspec 进行 测试 ， 测 试 文件 放 到 spec 文件 夹 里 。 


vendor 文件 夹 


这 是 第 三 方 代码 库 ， 比 如 我 们 clone 下 来 的 gem’ FRH js 库 等 。 


Gemfile 文件 
在 之 前 的 讲解 中 ， 我 们 经 常 提 到 Gem» 


Gem， 是 Ruby 编写 的 代码 库 的 发 布 包 。 一 个 Gem 中 还 可 以 包含 了 其 他 一 些 Gem， 比 如 ， 
Rails 就 是 个 Gem， 其 中 还 包含 了 activerecord > activesupport 这 些 Gem。 可 以 说 ，Rails 就 


是 一 大 堆 Gem 的 集合 。 
Rails 是 通过 Gemfile 文件 ， 来 管理 众多 Gem 的 。 


打开 Gemfile， 可 以 看 到 我 们 的 项 目 使 用 了 Rails 4.2.0 这 个 版 本 的 Gem， 使 用 了 sqlite3 这 个 
数据 库 ， 以 及 其 他 的 一 些 Gem， 这 都 是 Rails 4.2.0 默认 使 用 的 。 


我 们 是 可 以 修改 这 个 文件 ， 我 们 需要 bundle install ， 它 会 把 Gem 的 版 本 
号 和 互相 间 的 依赖 关系 重新 的 配置 一 遍 ， 并 且 会 自动 的 更 新 Gemfile.ock 这 个 文件 ， 然 后 安 
X Gefile.lock 中 声明 的 Gem ° 


所 以 ， 即 便 我 们 使 用 不 同 的 开发 机 器 ， 只 要 Gemfile.lock 相同 ， 我 们 就 会 安装 相同 的 Gem， 
以 保持 每 个 开发 机 器 使 用 相同 的 开发 和 运行 环境 。 
Rakefile 


Rails 为 我 们 提供 了 很 多 便捷 的 rake 任务 ， 我 们 通过 rake -T 可 以 看 到 ， 如 果 加 上 rake -T 
-D ， 可 以 看 到 详细 的 说 明 。 当 然 ， 我 们 页 可 以 自己 编写 rake， 把 它们 放 到 lib/tasks/ ZO > 3 
展 名 是 rake 。 


README.md 文件 


为 你 的 项 目 写 一 份 Readme 是 很 有 帮助 的 ， 你 有 注意 到 .md 这 个 格式 么 ?2 它 是 markdown 格 
式 ， 目 前 最 流行 的 书写 格式 ， 本 书 也 是 用 markdown 写成 的 。 


介绍 在 这 里 过 我 更 愿意 看 这 


我 创建 的 代码 ， 可 以 在 这 里 找到 : https://github.com/liwei78/rails-practice- 
code/tree/master/chapter 1/shop 


1.2.2 女装 Gem 


X Gem HH > Ruby (#3? X Ruby) 使 用 的 是 bundler 这 个 工具 。 它 的 官网 在 这 
里 : http://bundler.io/ 


在 我 们 配置 Gemfile 时 ， 经 常 遇 到 一 些 配 置 语法 ， 这 里 把 常见 的 介绍 下 : 


source 'https://rubygems.org' 
# source 'http://ruby.taobao.org' # 我 们 也 可 以 使 用 taobao 这 个 安装 源 ， 不 过 一 些 Gem 不 存在 时 ， 
还 是 要 使 用 rubygems 官方 源 的 。 


gem 'xxx', '~>2.0.3' # ~> 这 个 写法 表示 当前 版 本 大 于 等 于 2.0.3， 小 于 2.1 版 本 
gem 'xxx', '-22.1'  & ~> 这 个 写法 表示 当前 版 本 大 于 等 于 2.1， 小 于 3 .9 版 本 


gem 'my gem', '1.0', :source => 'https://gems.example.com' & 我 们 可 以 指定 自己 的 source 源 


gem 'nokogiri', :git => 'https://github.com/tenderlove/nokogiri.git', :branch => '1.4' 
# 也 可 以 指定 Github 地 址 和 分 支 


gem 'extracted library', :path => './vendor/extracted library' # 我 们 可 以 从 vendor 文件 夹 


中 安装 一 个 Gem» 


# 我 们 可 以 为 运行 环境 指定 一 个 group， 比 如 ， 在 development 和 production 环境 中 ， 将 不 加 载 rspec 
这 个 Gem， 它 只 需要 在 test 环境 下 工作 。 
group :test do 
gem 'rspec' 
end 


#1 http://bundler.io/gemfile.html > #4 # 2 Gemfile 的 介绍 。 


1.2.3 24 Rake 任务 


Rake 是 一 个 Ruby 实现 的 类 似 make 的 工具 程序 。 任 务 (Tasks) 是 由 Ruby 代码 编写 的 。 
这 么 讲 有 些 抽象 ， 我 们 看 看 Rails 为 我 们 提供 的 几 个 Rake 任务 : 


rake db:create # 创建 数据 库 

rake db:migrate # 更 新 数据 库 ， 更 新 的 文件 来 自 db/migrate/ 

rake db:seed # 执行 seed.rb 文件 的 内 容 ， 通 常 是 创建 一 个 默认 的 数据 。 
rake db:drop # 删除 数据 库 


上 面 这 些 命令 ， 是 在 development 环境 下 执行 的 ， 如 果 要 在 production 下 执行 呢 ? 
RAILS_ENV=production rake db:migrate 
另 一 个 常用 的 ， 是 


rake routes 


它 会 列 出 我 们 所 有 定义 的 路 由 (routes) 列表 。 


你 也 可 以 自己 编写 一 个 Rake 任务 ， 放 到 lib/tasks/ 中 ， 扩 展 名 为 rake » 


1.3 Pm (Ul) 设计 


概要 : 


本 课时 介绍 Bootstrap > YA Bootswatch UI， 通过 Gem 1f UI 文件 安装 到 Rails 项 目 中 。 
NANA UI 设计 思路 及 工具 。 


án ps AMA] 。 


1. Bootstrap 介绍 
2. Bootswatch 工具 及 Gem 
3. mybalsamiq 工具 


更 新 说 明 


在 新 书 编写 之 际 ， 对 当前 内 容 作 了 一 次 升级 。 原 代码 编写 于 2015 年 ， 在 此 之 后 有 不 少 版 本 的 
变动 和 bug 的 修复 ， 导 致 当时 的 一 些 代码 无 法 正确 运行 。 


本 节 中 ， 修 复 了 一 些 大 家 反馈 的 问题 ， 如 果 你 在 调试 时 遇 到 问题 ， 可 以 使 用 bundle update 
rails 升级 到 4.2.7.1， 并 且 bundle update sass-rails 升级 到 4.0.5 版 本 ， 经 过 我 的 调试 ， 
这 是 没有 异常 的 。 


1.3.1 Bootstrap 


大 家 好 ， 在 编写 我 们 项 目 代码 之 前 ， 我 先 讲 一 个 大 约 十 年 前 的 事情 。2005 年 创业 初期 ， 为 客 
户 制作 网 站 ， 有 一 次 ， 一 个 客户 找到 我 们 ， 说 要 开发 一 个 卖 花 的 网 站 ， 因 为 新 品 即将 上 市 ， 
所 以 有 一 些 急 。 于 是 ， 我 们 给 出 了 厚 厚 的 几 页 所 谓 的 “设计 方案 "。 但 是 客户 几 分 钟 就 否定 了 ， 
说 : 我 们 的 项 目 很 简单 ， 只 需要 购买 者 看 到 新 品 就 可 以 ， 可 以 预定 ， 我 们 货 到 付款 "。 于 是 ， 
我 们 把 多 余 的 设计 去 掉 后 ， 之 前 那 份 设计 方案 只 剩 下 三 分 之 一 了 。 但 是 客户 又 很 快 否 定 了 我 
们 的 方案 ， 说 : “我 能 先 看 看 样子 么 了” 


于 是 ， 我 们 让 设计 师 设计 好 了 几 个 样子 ， 交 给 客户 ， 客 户 又 把 我 们 否定 了 ， 而 且 显得 不 耐 
烦 。 他 抓 取 一 张 纸 和 一 支 铝 笔 ， 在 纸 上 画 出 了 他 要 的 样子 。 什 么 样子 呢 ? 


Lorem ipsum dolor sit amet, 
consectetur adipisicing elit, sed 
do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut 
enim ad minim veniam, quis 
nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea 
commodo consequat. Duis aute 
irure dolor in reprehenderit in 
voluptate velit esse cillum dolore 
eu fuaiat nulla pariatur Excenteur 





在 稍 后 商讨 细节 后 ， 我 们 很 快 完成 了 代码 功能 。 
这 件 事情 给 我 的 启发 是 : 

代码 之 前 ， 先 看 到 样子 
在 客户 画 出 样稿 前 ， 我 们 并 不 知道 新 品 只 有 几 种 ， 而 且 这 个 网 站 只 放置 新 品 。 它 所 突出 的 是 
在 线 预 定 和 货 到 付款 ， 即 宣传 了 新 品 ， 又 使 用 了 男 一 种 贴近 新 品 的 设计 风格 。 
回 到 我 们 的 例子 ， 我 们 还 没 开 始 Rails 项 目 之 前 ， 要 先 为 它 设计 一 个 样子 出 来 。 有 些 难 度 么 ? 
我 们 先 讲 一 个 接 下 来 要 帮助 我 们 的 前 端 设计 框架 : Bootstrap ° 


Bootstrap > X Á Twitter， 是 目前 最 受 欢迎 的 前 端 框架 。Bootstrap 是 基于 HTML ` 

CSS ` JAVASCRIPT 的 ， 它 简洁 灵活 ， 使 得 Web 开发 更 加 快捷 。[1] 它 由 Twitter 的 设计 
师 Mark Otto 和 Jacob Thornton 合 作 开 发 ， 是 一 个 CSS/HTML 框 架 。Bootstrap 提 供 了 优雅 
的 HTML 和 CSS 规 范 ， 它 即 是 由 动态 CSS 语 言 Less 写 成 。Bootstrap 一 经 推出 后 颇 受 欢 

迎 ， 一 直 是 GitHub 上 的 热门 开源 项 目 ， 包 括 NASA 的 MSNBC (微软 全 国 广播 公司 ) 的 
Breaking News 都 使 用 了 该 项 目 。 百 度 百科 


先 给 大 家 Bootstrap 的 官网 ， 这 里 可 以 找到 它 的 源 代码 ， 这 里 有 中 文 的 学 习 资 料 Bootstrap 
中 文 网 。 


在 读 Bootstrap 起 步 之 前 ， 我 先 介 绍 下 它 的 特点 : 


e 一 致 的 设计 风格 ， 丰 富 的 Web 组 件 ， 下 拉 菜 单 、 按 钮 组 、 按 钮 下 拉 菜 单 、 导 航 、 导 航 
Ay MAR. PH BER BBA BAH MER RAM ES 

e 支持 多 个 主流 浏览 器 

e HTML5 和 CSS3 开 发 

e 在 jQuery 的 基础 上 设计 ， 兼 容 大 部 分 jQuery 插件 

e 平台 自 适 应 ， 即 便 在 手机 ，pad 打开 网 站 也 没 问 题 





什么 ?ie6? 请 阅读 10 年 前 的 教程 吧 ， 如 果 还 能 找到 的 话 。 
在 这 里 ， 你 可 以 很 快 看 到 Bootstrap 的 模样 了 。 接 下 来 的 章节 里 ， 我 们 将 按照 这 个 样子 ， 设 
计 我 们 的 shop。 


rails new shop 


好 的 ， 我 们 给 它 添 加 个 几 个 gem ° 


gem "therubyracer" 
gem "less-rails" 
gem "twitter-bootstrap-rails" 


然后 ， 运 行 

bundle install 

之 后 ， 我 们 给 出 一 个 新 的 命令 ，scaffold : 

rails g scaffold product name price:decimal description:text 

scaffold 命令 我 们 将 在 下 一 章 详细 介绍 ， 这 里 ， 我 们 创建 了 一 个 资源 ，Product 。 


然后 ， 我 们 继续 运行 以 下 几 个 命令 


NO 


# 更 新 db 解构 

rake db:migrate 

# 安装 bootstrap 文件 

rails generate bootstrap:install 
# 创建 一 个 layout 

rails g bootstrap:layout 

# 创建 资源 模板 

rails g bootstrap:themed Products 


是 不 是 还 有 不 熟悉 的 命令 ， 我 们 后 面 的 章节 详细 介绍 他 们 ， 现 在 ， 你 可 以 运行 


rails s 


来 启动 Rails 项 目 了 ， 访 问 nttp://localhost:3000/products ， 你 会 看 到 这 个 页 
Bootstrap 风格 的 页 面 了 。 


€ > Œ [localhost:3000/products 





RailsBootstrap Linkt Link2 — Link3 


Products Sidebar 
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Id Name Description Created at Actions 
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@ Company 2015 


把 它 缩 小 看 看 
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€ > C |D localhost:3000/ products e 
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Products 


Id Name Description Created at Actions 
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Link3 
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是 的 ， 即 便 你 用 手机 来 访问 它 ， 也 不 会 让 页 面 乱 掉 。 
我 们 用 的 是 这 个 gem， 你 可 以 详细 的 看 看 它 的 文档 。 


https://github.com/seyhunak/twitter-bootstrap-rails 


1.3.2 Bootswatch 


TKRAKTH-ETA? 
的 确 ， 大 多 数 项 目 开 始 的 时 候 都 是 一 个 样子 ， 是 件 让 人 气 狠 的 事情 。 我 们 来 给 它 增加 点 不 
同 。 
这 里 再 介绍 一 个 可 以 帮助 我 们 的 项 目 ，Bootswatch 


我 们 在 刚才 的 Gemfile 中 ， 再 添加 两 个 gem : 


NO 


Cn 


A PRA (Ul) 设计 


gem 'twitter-bootswatch-rails' 
gem 'twitter-bootswatch-rails-helpers' 


在 我 们 的 项 目 中 ， 和 运行 下 面 的 两 个 新 命令 : 


rails g bootswatch:install cerulean # 安装 该 theme 的 基础 文件 
rails g bootswatch:import cerulean # 导入 一 个 线 上 的 theme 的 变量 文件 


ioc: 我 们 使 用 的 Gem 中 ， 会 存在 bug， 或 者 ， 版 本 更 新 导致 的 Gem 不 匹配 ， 也 会 引起 
Bug。 这 时 候 ， 我 们 可 以 帮助 作者 改进 它 。 当 然 ， 你 要 先 十 分 确定 ， 它 是 一 个 Bug ! 


我 们 修改 一 下 application.css 中 的 引用 : 


*= require cerulean/loader 
*- require cerulean/bootswatch 


我 们 可 以 看 到 
€ > CG |" localhost:3000/products# ze (»sz 


Bootstrap theme = 


Products 


Id Name Description Created at Actions 


当然 ， 事 情 并 未 像 上 面 写 的 如 此 容易 。 我 在 为 大 家 写 这 段 代码 的 时 候 ， 就 遇 到 了 很 多 问题 
还 好 ， 都 一 一 解决 了 。 你 可 以 到 这 里 看 到 我 调试 好 的 代码 。 


在 这 里 ， 我 为 大 家 选择 了 三 套 不 同 的 bootswatch theme， 大 家 可 以 练习 。 
Bootswatch-rails 的 代码 在 这 里 : 


https://github.com/scottvrosenthal/twitter-bootswatch-rails 
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Rails 和 Ruby 一 样 ， 是 为 有 经 验 的 开发 者 准备 的 。 


作为 初学 者 ，Rails 的 确 会 为 大 家 提出 很 多 问题 ， 有 些 问 题 会 占用 大 量 的 时 间 ， 让 人 失去 耐 
心 。 虽 然 开发 了 很 多 年 的 Rails 项 目 代 码 ， 我 也 会 经 常 遇 到 各 种 问题 。 所 以 ， 请 大 家 耐心 ， 让 
我 们 一 起 弄 清 思 路 ， 慢 慢 解 决 。 


1.3.3 UI Kit 

本 节 ， 让 我 们 轻松 一 下 。 

你 有 注意 到 1.3.1 里 的 那 张 图 么 ? 对 了 ， 它 是 用 www.mybalsamiq.com 画 的 。 
让 我 们 继续 为 即将 开始 的 shop 项 目 ， 画 几 张 图 吧 。 

首先 ， 我 们 想 想 ， 我 们 需要 哪些 页 面 。 


1. 首页， 列 出 我 们 推荐 的 商品 《Product) 
2. 列表 页 ， 根 据 选 择 的 分 类 ， 列 出 该 分 类 下 的 商品 
3， 展 示 页 ， 查 看 每 一 个 商品 


好 的 ， 我 们 画 出 心里 构思 好 的 页 面 。 


我 们 的 首页 


Index 
QUO XQ TINIO 
S| [ml kaa na 


LOGO 


P sil nA Product Name Product Name 


Lorem ipsum dolor sit $ 19.99 $ 19.99 


amet, consectetur 


adipisicing elit, sed do [se] LCB 


eiusmod tempor 
incididunt ut labore et 


dolore magna aliqua. Ut 
enim ad minim veniam, Buy > Buy > 
quis nostrud exercitation 


ullamco laboris nisi ut 
aliquip ex ea commodo 


consequat Product Name 


tag tog tog tag $ 19.99 


tag tag tog BE 


tag tag .. ta 

tag tag tag tog 

tag tag tag b Buy > 
tag tag tag tog 
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我 们 的 列表 页 


Product Name Product Name 


Lorem ipsum dolor sit $ 19.99 
amet, consectetur 


adipisicing elit, sed do BE 

eiusmod tempor 

incididunt ut labore et 

dolore magna aliqua. Ut 

enim ad minim veniam, b Buy > b Buy > 
quis nostrud exercitation 


ullamco laboris nisi ut 
aliquip ex ea commodo 


consequat Product Name Product Nome 


tag tag tag tag 
tag tag tog io 
ma tog KAG tog 
tag tag tag 
tag tog tag tog 
m tag tag tag 
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我 们 的 展示 页 


用 户 界 面 (UI) 设计 


Od XQ me 


| Home | Polo T-Shirt Jacket Hat 


Home ) Shirt » A product 





A Subtitle 


Lorem ipsum dolor sit amet, 
consectetur adipisicing elit, sed 
do eiusmod tempor incididunt ut 
labore et dolore magna aliqua. Ut 
enim ad minim veniam, quis 
nostrud exercitation ullamco 
laboris nisi ut aliquip ex ea 
commodo consequat. Duis aute 
irure dolor in reprehenderit in 
voluptate velit esse cillum dolore 
eu fugiat nulla pariatur. Excepteur 


$19.99 [LB 
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我 想 讲 几 个 我 们 设计 上 的 细节 


o 


e 首页 ， 我 们 展示 的 是 属性 为 置顶 (top = true) 的 商品 
e 列表 页 ， 我 们 有 商品 分 页 。 
e 展示 页 ， 当 前 分 类 和 导航 中 的 分 类 是 选中 状态 。 
当然 ， 我 们 的 原型 设计 不 止 这 三 张 图 ， 在 后 面 的 代码 阶段 ， 我 们 将 会 根据 需要 ， 再 设计 其 他 
的 页 面 。 
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下 一 节 ， 我 们 将 使 用 scaffold 这 个 命令 ， 来 创建 我 们 的 第 一 个 资源 。 我 们 下 一 节 再 见 。 


第 二 章 Rails 中 的 资源 


课程 概要 : 


本 课程 讲解 Rails 中 的 资源 ， 通 过 scaffold 命令 创建 资源 ， 并 对 资源 文件 的 类 型 、REST 风格 
设计 及 路 由 文件 进行 讲解 ， 理 解 Rails 如 何在 REST 架构 下 如 何 进 行 资 源 的 管理 。 


知 qui AAAN 


1. scaffold 命令 


2. REST 
3. routes 
` Ab 
RAHE 


Rails 是 REST 风格 的 web 开发 框架 ， 通 过 本 课程 的 学 习 ， 可 以 理解 Rails 是 如 何 通 过 对 资源 
的 管理 ， 实 现 REST 架构 的 。 


2.1 应 用 scaffold 命令 创建 资源 


概要 : 


本 课时 详细 介绍 Rails 中 的 命令 ， 以 及 使 用 scaffold 命令 创建 的 资源 文件 ， 如 erb 文件 ， 测 试 
文件 ，sass 文件 等 。 


4n 1R ANN : 


scaffold 
sass/scss 

. coffeescript 
erb 


a kwon a 


rspec 


EC 


2.1.1 rails 命令 


Esp 9 aie new 创建 了 一 个 Rails 项 目 ， 并 且 使 用 了 下 面 的 命令 ， 创 建 了 商品 
(Product) 这 个 资源 : 


% rails g scaffold product name price:decimal description:text 


g 是 generate 的 缩写 ，Rails 还 为 我 们 提供 了 几 个 类 似 的 命令 : 


% rails -h 
generate 生成 资源 文件 (简写 "g") 


console 运行 调试 控制 台 (简写 "c") 

server 运行 Rails 服务 (简写 "s") 

dbconsole ”运行 数据 库 调试 控制 人 台 (简写 "db") 

new 创建 新 的 Rails 项 目 。 你 也 可 以 "rails new ." 它 会 在 当前 目录 下 创建 
destroy 删除 "generate" 创建 的 文件 (简写 "d") 

plugin new 创建 一 个 plugin 

runner 在 Rails 环境 下 ， 执 行 一 段 Ruby 代码 


我 们 用 generate 可 以 创建 资源 ， 同 样 也 可 以 用 destroy 删除 这 个 资源 ， 比 如 : 


% rails destroy scaffold product 


我 们 已 经 使 用 server 命令 运行 了 项 目 ， 但 是 ， 有 时 候 我 们 不 一 定 要 在 web 页 面 上 做 操作 ， 为 
了 方便 调试 ， 我 们 可 以 已 进入 到 互动 终端 ， 也 就 是 Console 中 : 


96 rails console 
» Product.first 
Product Load (0.2ms) SELECT "products". FROM "products" ORDER BY "products"."id" A 
SC LIMIT 1 
-» nil 
> exit 


在 console 里 ， 我 们 可 以 方便 的 操作 数据 库 ， 下 一 章 我 们 会 重点 讲解 数据 库 部 分 。 


和 console 类 似 ，dbconsole 可 以 进入 到 数据 库 的 互动 终端 里 ， 具 体 的 命令 取决 去 使 用 的 哪个 
数据 库 ，rails 只 是 为 我 们 提供 了 一 个 方便 的 连接 数据 库 方式 。 


plugin 命令 可 以 为 一 个 独立 的 功能 创建 专属 的 代码 ， 并 且 存 在 与 该 Rails 项 目 中 ， 在 Rails 3 
之 后 ， 越 来 越 多 的 功能 使 用 gem 来 实现 ，plugin 较 少 使 用 了 。 


fe console 的 交互 式 操作 不 同 ，runner 可 以 执行 一 段 代 码 ， 相 同 的 是 ， 它 们 都 拥有 当前 项 目 
完整 的 Rails 环境 。 我 们 可 以 使 用 执行 一 个 文件 ， 比 如 : 


96 rails runner lib/somefile.rb 
在 这 个 file 里 ， 可 以 实现 一 些 功能 ， 这 和 rake 的 实现 方式 较 接 近 。 


2.1.2 scaffold 命令 
回 到 我 们 经 常 使 用 的 generate 命令 ， 先 查看 帮助 文档 : 


% rails generate -h 


我 们 看 到 ，generate 可 以 创建 很 多 类 型 的 文件 ， 比 如 model > controller > assets 文件 等 ， 这 
些 都 是 一 个 Rails 资源 所 需要 。 我 们 可 以 分 别 执行 generate 命令 ， 也 可 以 把 它们 一 次 都 执 
行 ， 这 就 是 scaffold 。 


scaffold 的 中 文 称呼 是 “脚手架 *"， 个 人 觉得 它 不 是 很 形象 ， 如 果 称 它 为 “一 大 堆 generator (+ 
成 器 ) 的 集合 "， 似 乎 形象 很 多 。Rails 为 我 们 提供 了 一 些 generator， 我 们 也 可 以 编写 自己 的 
generator ° 


再 来 看 看 scaffold 的 语法 结构 : 


% rails g scaffold [资源 名 ] [属性 列表 ] [选项 ] 


为 了 使 我 们 的 网 店 更 接近 实际 应 用 ， 我 们 再 增加 一 个 资源 : 商品 类 型 (Variant) 


% rails g scaffold variants product id:integer price:decimal{'8,2'} size 


variants 是 资源 的 名 称 ， 它 可 以 是 单数 ， 我 们 创建 商品 时 用 的 就 是 单数 形式 。 属 性 列表 里 ， 属 
性 名 称 和 属性 的 类 型 ， 使 用 RA Ri RAL string > PM color 的 后 面 没 有 声明 它 是 
什么 类 型 ， 那 么 它 就 是 string 类 型 。 


当 我 们 创建 价格 类 型 的 时 候 ，decimal 可 以 增加 两 个 具体 参数 : precision 和 scale， 每 个 数据 
库 的 默认 值 是 不 同 的 ， 我 们 可 以 查看 这 里 : 


RMDB 的 decimal 默认 值 
我 们 打开 config/routes.rb ， 可 以 看 到 这 样 两 行 代码 已 经 添加 了 : 


生成 文件 的 时 候 ， 我 们 注意 到 这 一 行 : 


resources :products 
resources :variants 


这 就 是 我 们 定义 的 资源 。 其 实 ， 我 们 说 URL PAR 就 是 这 个 资源 Resource 的 意思 。 我 们 可 
以 这 样 理 解 Rails : 


Rails 是 从 管 PIPZ YF 73. 开始 o 
我 们 还 可 以 配置 scaffold， 让 它 跳 过 一 些 不 必要 的 文件 ， 配 置 写 在 config/application.rb 
v: 

class Application « Rails::Application 


config.generators do |cfg| 


cfg.stylesheets false 

cfg.javascripts false 

cfg.helpers false 
end 


ii 4 > scaffold 命令 就 不 再 创建 helper * css’ js 文件 了 。 但 在 我 们 学 习 初 期 阶段 ， 先 不 这 人 么 
做 。 


2.1.3 sass/scss 


创建 的 文件 中 ， 我 们 看 到 了 .scss 的 文件 ， 其 实 ， 它 是 sass 文件 ， 一 种 css 的 预 处 理 文 
件 ， 它 的 后 级 有 两 种 : .scss 和 .sass ° scss 语法 更 接近 css 本 身 ， 你 可 以 直接 粘贴 css 
来 使 用 。sass 语法 更 加 简洁 ， 它 去 掉 了 ; 和 {} 这 些 符号 ， 并 且 使 用 空格 ， 作 为 语法 缩 
进 。 


使 用 sass， 可 以 使 用 预定 义 变量 ， 使 用 语法 褒 套 ， 代 码 混 入 等 多 种 编程 风格 的 代码 ， 编 写 
css， 并 且 在 编译 成 css 文件 的 过 程 中 ， 还 可 以 进行 语法 检查 。 


sass 和 scss 写法 上 的 不 同 ， 可 以 在 http://sass-lang.com/guide (中 文 文档 ) 看 到 。 


如 果 你 想 在 两 种 文件 间 转 换 ， 可 以 使 用 这 个 命令 : 


# Convert Sass to SCSS 
96 sass-convert style.sass style.scss 


# Convert SCSS to Sass 
96 sass-convert style.scss style.sass 


SASS 用 法 指南 一 文 里 有 更 详细 的 介绍 。 


Rails 默认 使 用 的 是 sass， 这 里 是 它 github 的 地 址 ， 


在 我 们 的 css 文件 中 ， 经 常会 使 用 图 片 文件 ， 比 如 background-image 属性 ， 但 是 我 们 的 图 片 
是 放 在 assets 文件 夹 中 的 ， 我 们 可 以 有 三 种 方式 来 使 用 图 片 。 


第 一 种 ， 直 接 粘 贴图 片 地 址 ， 比 如 : 


background-image: url("/assets/logo.png"); 


这 是 很 不 好 的 ， 它 不 能 使 用 digest 方式 来 使 用 图 片 资源 ， 也 不 够 灵活 。 


第 二 种 ， 将 图 片 文件 放 到 public 下 ， 比 如 : 


background-image: url("/images/logo.png"); 


需要 我 们 在 public 下 建立 一 个 images 文件 夹 来 管理 图 片 文件 ， 也 不 能 使 用 digest 。 


第 三 种 ， 直 接 使 用 sass-rails 提供 的 辅助 方法 : 


background-image: asset-url('logo.png'); 


当然 ， 我 也 见 到 过 第 四 种 方法 ， 使 用 erb 来 重 构 sass， 文 件 可 能 是 这 样 
的 ， style.css.scss.erb ， 这 样 就 可 以 在 scss 里 插入 erb 的 语法 : 


background-image: url(<%= asset path 'logo.png' 965), 


在 Rails 里 是 可 以 这 么 写 的 ， 它 会 先 解析 erb 文件 ， 再 解析 sass 文件 ， 生 成 css。 但 是 我 不 
建议 这 么 处 理 问 题 ， 在 我 们 使 用 一 个 不 熟悉 的 方法 解决 问题 时 ， 应 该 多 耐心 看 一 看 它 的 文 
档 。 不 知道 这 里 给 出 的 众多 链接 ， 天 家 是 否 查看 了 ， 他 们 都 是 对 内 容 很 好 的 补充 。 


和 sass 一 样 ，Less 也 是 css 的 预 编译 工具 ， 如 果 你 留意 bootstrap 的 介绍 ， 它 的 css 文件 就 
是 用 less 编写 的 。 


2.1.4 coffeescript 


.coffee 是 js 的 预 处 理 文件 ， 它 是 用 coffeescript 编写 的 。 学 习 它 很 简单 ， 只 要 看 
A http://coffeescript.org/ 就 可 以 了 ， 中 文 在 http://coffee-script.org/。 
scss 和 coffeescript 的 目标 ， 是 让 代码 更 简洁 ， 易 维护 。 预 处 理 还 可 以 帮 你 检查 语法 上 的 错 
误 。 


在 我 们 安装 完 bootstrap 后 ， 会 给 出 一 个 coffee 文件 : 


jQuery -» 
$("a[rel--popover], .has-popover").popover() 
$("a[rel--tooltip], .has-tooltip").tooltip() 


2.1.5 erb 
最 后 ， 我 们 说 说 erb » 
erb 是 Ruby 的 标准 库 (Standard Library) 之 一 ， 它 允许 是 把 Ruby 代码 签 入 到 html 中 。 


一 个 简单 的 例子 ， 我 们 进入 到 irb 中 : 


% require "erb" 

96 name = "Ruby" 

96 ERB. new("My name is #{name}").result 
=> "My name is Ruby" 


好 了 ， 文 件 都 介绍 完了 ， 我 们 看 一 下 效果 吧 ， 我 们 使 用 下 面 的 命令 : 


% rake db:migrate [1] 
% rails s [2] 


e [1] 更 新 数据 库 
。 [2] 启动 Rails 服务 ，s X server 的 简写 


访问 http://localhost:3000/products ， 试 试 上 面 的 按钮 ， 体 验 一 下 如 何 增加 ， 人 修改， 删除 一 
个 商品 (Product) 吧 。 


2.1.6 测试 


除了 上 面 介绍 的 ，scaffold 还 为 我 们 添加 了 测试 文件 test/models/product test.rb 和 


test/controllers/products controller test.rb ° 


R F > Rails 默认 使 用 的 是 minitest， 更 多 介绍 可 以 看 这 里 。 我 们 也 可 以 使 用 其 他 的 测试 杠 
架 ， 比 如 Rspec ° 


我 们 可 以 修改 Gemfile 


group :development, :test do 
gem 'rspec-rails' 
end 


运行 rspec 的 generator : 


96 rails generate rspec:install 
create .rspec 

create spec 

create spec/spec helper.rb 
create spec/rails helper.rb 


我 们 补 上 Model 和 Controller 的 测试 文件 : 


rails generate rspec:model product 
rails generate rspec:controller products 


最 后 ， 我 们 在 Rails 项 目 文件 夹 中 运行 这 个 命令 : 


% rspec 


kk 


Pending: (Failures listed here are expected and do not affect your suite's status) 
1) ProductsController 
# Not yet implemented 
# ./spec/controllers/products controller spec.rb:4 
2) Product add some examples to (or delete) /Users/liwei/Desktop/Rails practice pi 0 
/code/chapter 2/shop/spec/models/product spec.rb 


# Not yet implemented 
# ./spec/models/product spec.rb:4 


Finished in 0.00058 seconds (files took 1.6 seconds to load) 


我 们 看 到 测试 文件 已 经 可 以 运行 了 ， 虽 然 我 们 还 未 给 它 写 一 行 测试 用 例 (Test Case) » 
在 后 面 MVC 开发 的 部 分 ， 我 们 会 继续 添加 它 的 代码 。Rspec 的 代码 和 文档 在 这 里 : 
https://github.com/rspec/rspec 


让 Rspec 集成 到 Rails 中 的 方法 是 安装 rspec-rails 


group :development, :test do 
gem 'rspec-rails', '-» 3.0' 
end 


https://github.com/rspec/rspec-rails 


下 一 节 ， 我 们 将 深入 Rails 中 ， 了 解 它 的 核心 概念 : REST ° 


应 用 scaffold 命令 创建 资源 
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2.2 REST #44 


概要 : 


本 课时 结合 Rails 路 由 (routes) ， 详 解 Rails 如 何 实现 REST 架构 。 


An TR ANN : 


1. REST 
2. CRUD 


正文 


2.2.1 什么 是 REST 


REST * Representational State Transfer ， 更 准确 地 表述 应 该 是 : 具有 代表 性 的 状态 转移 。 
这 是 一 种 软件 架构 风格 。 说 它 是 风格 ， 表 明 它 不 具备 约束 。 你 可 以 破坏 它 ， 不 按照 它 的 风格 
去 实现 。 但 是 ，REST 拥有 简洁 的 设计 理念 ， 按 照 它 的 设计 可 以 在 开发 中 获得 益处 。 
Rails 是 按照 REST 风格 设计 的 ， 从 1.2 版 本 起 ，Rails 就 开始 按照 REST 架构 管理 资源 。 
如 何 管理 呢 ? Rails 从 以 下 三 个 方面 对 资源 进行 定义 : 
1. 直观 简短 的 资源 地 址 : URI, kite : http://example.com/resources/ 。 
2， 可 传输 的 资源 : Web 服务 接受 与 返回 的 互联 网 媒体 类 型 ， 比 如 : JSON? XML > YAML 
等 。 
3. 对 资源 的 操作 : Web 服务 在 该 资源 上 所 支持 的 一 系列 请 求 方法 (比如 : POST > GET? 
PUT 或 DELETE) 。 
在 我 们 的 代码 里 ， 我 想 你 已 经 在 上 一 节 创 建 的 项 目 里 体验 到 了 如 何 增加 ， 修 改 ， 和 删除 一 个 
商品 。 
以 上 引述 于 http://zh.wikipedia.org/wiki/REST， 并 结合 Rails 做 了 解释 。 这 里 还 有 一 篇 文章 ， 
推荐 阅读 : 如 何 获 取 (GET) 一 杯 咖 啡 一 一 星巴克 REST 案 例 分 析 





REST 是 资源 管理 的 模式 ， 和 SOAP 和 XML-RPC 相 比 更 加 简洁 ， 下 一 节 ， 我 们 介绍 Rails X 
如 何 管 理 资源 的 。 


2.2.2 CRUD ， 资 源 的 增删 改 查 


首先 ， 我 们 在 Rails 中 定义 一 个 资源 ， 我 们 在 routes 中 使 用 resources 这 个 方法 : 


Rails.application.routes.draw do 


resources :products 


% rake routes | grep product 
products GET 
POST 
new product GET 
edit product GET 
product GET 
PATCH 
PUT 


/products(.:format) 
/products(.:format) 


/products/:id/edit( 


/products/new(.:format) 


.:format) 


/products/:id(.:format) 
/products/:id(.:format) 
/products/:id(.:format) 


DELETE /products/:id(.:format) 


products#index 
products#create 
products#new 
products#edit 
products#show 
products#update 
products#update 
products#destroy 


Rails 为 我 们 提供 了 7 个 方法 ， 他 们 在 app/controllers/products controller.rb 这 个 文件 中 。 


4 4&4] GET /products 这 个 地 址 时 ， 调 用 的 是 index 方法 ， 当 我 们 POST /products 地 
址 时 ，Rails 会 按照 REST 的 模式 ， 把 请 求 转 入 到 create 方法 内 。 我 们 看 一 下 这 个 表 : 


HTTP 请 求 方法 在 RESTful Web 服务 中 的 典型 应 用 


一 组 资源 的 URI ， 比 如 
http://example.com/resources/ 


单个 资源 的 URI ， 比 如 
http://example.com/resources/142 


GET PUT POST 
列 出 aa kami 
URI ZA 的 一 源 中 创建 / 
该 资源 组 pap 追加 一 个 
中 每 个 资 ga 新 的 次 
源 的 详细 换 当 源 。 该 操 
信息 (后 au MIRER 
A e 回 新 资源 
$) 。 "A URL ° 
M : 替换 / 
> ESL d g R 
tne | 创建 “| 把 指定 的 
m 指定 资源 当做 
LI 格式 的 资 eed 资源 
可 以 自选 组 ， 并 在 
AA | 并 将 | 其 下 创建 
其 追 追加 一 个 
的 网 络 媒 Alan 新 的 元 
KRA SOME Ex 
NE 相应 素 ， 使 其 
MES 的 资 RATS 
源 组 前 资源 。 
JSON 等 ) 


DELETE 


删除 整 组 


所 以 ， 向 PATCH 或 PUT 的 地 址 是 一 个 具体 的 资源 ， 比 如 /products/1 * Mm Rails 会 把 请 求 
转移 到 update 方法 中 。 值 得 注意 的 是 : 在 之 前 的 Rails 版 本 中 ， 用 的 是 PUT 动作 ，4.0 后 
引入 PATCH ， 稍 微 不 同 的 是 ，patch 可 以 表示 更 新 或 局 部 更 新 ， 但 在 使 用 上 ， 和 PUT LHe 
[1] 


format 表示 我 们 可 以 接受 和 响应 对 应 的 format 请 求 。 比 如 /products/1 响应 的 是 html? 
而 /products/1.json 响应 的 是 json 9 


我 们 可 以 关闭 这 种 响应 ， 只 需要 resources :products, format: false 。 
或 者 更 改 响 应 ， 只 接受 和 响应 json > k : resources :products, format: 'json' ° 


在 实践 中 ， 这 对 APL 的 设计 非常 方便 ， 比 如 页 面 上 ajax 调用 /api/users/1/status ° ARE 
只 返回 json 格式 。 


从 现在 开始 ， 我 们 的 代码 主要 集中 在 app 文件 夹 内 。 下 一 节 ， 我 们 将 深入 Rails 的 routes 
中 ， 看 看 实践 中 经 常 遇 到 的 情况 ， 以 及 如 何 解 决 。 你 也 可 以 请 先 阅读 以 下 Rails 手册 中 的 
routes 章节 。 

阅读 


REST 服 务 开发 实战 


为 哈 REST 如 此 重要 ? 


2.3 深入 路 由 (routes) 


概要 : 


本 课时 详细 解读 如 何 设置 复杂 情况 下 的 路 由 (routes) ， 以 及 路 由 文件 中 常用 方法 。 


4n qu ANNN ; 


routes 定义 
#&# (nested) 
namespace 
concern 

参数 

测试 


DA BA ON > 


正文 


2.3.4 定义 路 由 (routes ) 


上 一 节 ， 我 们 讲 了 Rails 通过 routes， 来 实现 REST 风格 的 架构 。 本 节 我 们 讲 详 细 介 绍 下 如 
何 使 用 routes， 定 义 我 们 想 要 的 地 址 (URL) © 


我 们 先 为 项 目 ， 创 建 一 个 controller : 


rails g controller home index welcome about contact 


在 我 们 专门 讲解 controller 前 ， 先 简单 解释 下 : 


e g = generate 的 缩写 ， 我 想 你 已 经 在 2.1.1 里 看 到 了 。 

e controller， 说 明 我 们 创建 的 是 一 个 controller ， 也 可 以 是 model。 

e home x controller 的 名 字 。 

e index... 和 其 他 几 个 名 字 ， 是 controller 中 的 方法 ， 并 且 会 自动 创建 对 应 的 views 文件 。 


好 了 ， 我 们 在 它 上 面 做 一 些 简单 的 例子 ， 打 开 routes， 你 可 以 看 到 它 已 经 增加 了 几 个 定义 : 


get 'home/index' 
get 'home/welcome' 
get 'home/about' 
get 'home/contact' 


我 们 访问 http://localhost:3000/home/index 可 以 看 到 它 。 但 是 ， 如 果 我 想 访问 
http://localhost:3000/ 就 进入 到 index FAR? 


get '/', to: 'home#index' 
get '/welcome', to: 'home#welcome' 


如 上 ， 我 们 自己 定义 了 访问 和 方法 之 间 的 对 应 关系 。 其 实 我 们 更 经 常 使 用 root 来 定义 地 址 : 


root 'home#index' 


运行 rake routes ， 我 们 可 以 看 到 


Prefix Verb URI Pattern Controller#Action 
home contact GET /home/contact(.:format) home#contact 
GET / home#index 
welcome GET /welcome(.:format) home#welcome 
root GET / home#index 


我 们 也 可 以 用 其 他 的 Verb x 3 3E GET 请 求 ， 比 如 


put '/haha', to: 'home#index' 
delete '/hehe', to: 'home#index' 
patch '/wawa', to: 'home#index' 


routes 中 我 们 可 以 抛 开 资 源 的 要 求 (3E REST 风格 ) ， 直 接 设 定 一 个 访问 地 址 : 


get '/something/:controller/:name/:action' 


这 时 我 们 访问 http://localhost:3000/something/home/aaa/index 也 会 进入 到 'home#index' 
中 ， 因 为 Rails 会 这 样 解析 : 


e something 是 个 前 缓 

e 访问 的 controller 是 home 
e name 参数 是 aaa 

e Z ik index 


建议 你 看 一 下 的 终端 : 


Started GET "/something/home/aaa/index" for ::1 at 2015-02-19 17:10:26 +0800 
Processing by HomeController#index as HTML 
Parameters: {"name"=>"aaa"} 


Rails 已 经 将 你 的 请 求 转移 到 对 应 的 controller PT ° 


如 果 一 个 地 址 ， 即 可 以 接收 post 请 求 ， 也 可 以 接收 get 等 请 求 ， 我 们 可 以 使 用 match 方法 : 


match ':controller/:action/:id', via: [:get, :post] 
提示 : 在 开发 (development) 环境 中 ， 修 改 routes 是 不 需要 重启 服务 的 。 


2.3.1.1 扩展 resources 


前 面 我 们 已 经 定义 了 一 个 resource :products ， 这 在 实际 开发 中 还 是 不 够 的 ， 比 如 ， 一 个 
Product 下 如 果 查 看 评论 ， 比 如， 显示 卖 的 最 好 的 十 个 Products : 


resources :products do 
collection do 
get :top # 排行 榜 功能 
end 
member do 
post :buy # 添加 到 购物 车 
end 
end 


运行 rake routes 可 以 看 到 : 


Prefix Verb URI Pattern Controller#Action 
top_products GET /products/top(.:format) products#top 
buy_product POST /products/:id/buy(.:format) products#buy 


KIA * collection 用 于 products ¥ 2$ 7s 2 > * member 给 具体 一 个 product 增加 方法 。 


补充 一 点 ， 我 们 可 以 在 一 行 里 ， 定 义 多 个 resources， 比 如 : 


resources :photos, :books, :videos 


虽然 方便 ， 但 不 够 灵活 ， 实 践 中 还 是 要 按照 需求 调整 的 。 


我 们 在 这 里 提出 了 两 个 功能 需求 : top 排行 榜 ， 和 添加 到 购物 车 。 这 里 我 使 用 trello.com 来 记 
录 这 两 个 需求 。 








f& Chrome File Edit View History Bookmarks Window People Help no Ba iz 
[909 /四 ss (produ) on rails» x NN | wei | i? 
€ Q | B https://trello.com/c/IzGPbWoe/1-product NG = 


商品 (product) in list 计划 


Edit the description Add 


Members 
Checklist 

Labels 
所 有 商品 的 top 排 行 榜 Checklist 
每 一 个 商品 的 buy 方 法 ， 加 入 购物 车 

Due date 
Add an item 

Attachment 
Acthiity Actions 


] 
t7 Write a comment.. Move 


Copy 


Wi liwei 
* moved from 进行 中 to 计划 Subscribe 
* completed 每 一 个 商品 的 buy 方 法 ， 加 入 购物 车 
. completed 所 有 商品 的 top 排 行 榜 Archive 


Share and more. 
I. liwei moved this card from 完成 to 计划 . 8 minutes ago 





i liwei added this card to To-Do and added Checklist. 18 minutes ago 


KAL EH T —4 i ， 在 checklist 中 记录 了 这 两 个 需求 。 当 我 们 开始 功能 开发 的 时 
候 ， 可 以 将 card 拖 动 到 “进行 中 ”， 当 我 们 完成 一 个 功能 的 时 候 ， 可 以 在 checklist 的 项 目前 打 
一 个 \， 当 我 们 完成 一 个 card 的 任务 后 ， 可 以 讲 card 拖 动 到 "完成" 中。 


Rails 被 很 多 开发 团队 使 用 ， 在 一 些 开 发 团队 中 ， 经 常会 提 到 敏捷 开发 ，trello 是 一 个 很 好 的 
敏捷 开发 工具 ， 可 以 方便 的 管理 我 们 的 日 常 工作 ， 和 记录 项 目 进展 状态 。 


2.3.1.2 单个 资源 resource 


resource :Settings 
resource :profile 


这 是 设 定 一 个 单数 资源 的 方法 ， 项 目 里 ， 哪 些 是 单数 呢 ? 比如 系统 设 定 ， 比 如 当前 用 户 的 个 
人 人 信息， 运行 rake routes 可 以 看 到 ， 它 是 没有 sid 这 个 参数 的 。 

在 这 个 例子 里 ， 我 们 还 未 给 settings 和 profile 创建 controller 和 view， 不 过 这 不 妨碍 routes 
产生 我 们 想 要 的 地 址 。 

2.3.1.3 3 选择 方法 


resources 给 我 们 创建 了 七 个 方法 ， 但 是 不 见得 我 们 都 要 用 到 ， 为 了 代码 的 整洁 [1]， 我 们 可 
以 做 一 些 排除 : 


resources :users, only: [:index, :show] 
resources :products, except: [:destroy] 


only 表示 我 们 需要 的 方法 ， except 表示 我 们 不 需要 的 方法 。 通 常 ， 我 们 的 确 会 像 上 面 这 人 么 
做 ， 比 如 我 们 的 网 站 只 提供 用 户 (User) 的 列表 和 查看 功能 ， 而 管理 功能 (增删 改 ) 要 在 管 
理 界 面 进行 ， 而 它 的 地 址 一 般 不 会 是 /users/1/edit 这 样 ， 而 是 /admin/users/1/edit ° 


[1] 这 是 个 人 癖 好 ， 有 的 人 的 确 不 愿意 这 么 做 ， 不 过 Rails 给 了 我 们 让 项 目 变 得 "整洁 "的 方法 。 


2.3.1.5 地 址 解析 的 辅助 方法 
刚才 ， 我 们 讲 到 了 path 这 个 后 级 ，Rails 还 有 一 个 url ° 


地 址 结果 
products_path 'Iproducts' 
products url 'http://localhost:3000/products' 


“path 和 url X routes 的 辅助 方法 ， 我 们 在 下 一 章 将 详细 介绍 。 


2.3.2 x Ah% (routes) 


在 我 们 定义 资源 的 时 候 ， 有 时 候 一 个 资源 会 有 它 的 子 资 源 ， 比 如 一 个 商品 (product) 会 有 多 
个 商品 种 类 (variants) ， 当 我 们 购买 一 个 商品 的 时 候 ， 也 需要 选择 哪个 种 类 ， 比 如 T 恤 的 种 
类 氛围 尺码 ， 而 每 一 个 尺码 有 不 同 的 价格 。 


这 时 该 如 何 定义 routes 呢 ? 


resources :products do 
resources :variants 
end 


运行 rake routes ， 可 以 看 到 一 个 商品 (product) 下 ， 增 加 了 这 些 routes : 


Prefix 


product variants 


new product variant 
edit product variant 


product variant 


RAIA variants 也 使 用 一 下 scaffold 


Verb 
GET 
POST 
GET 
GET 
GET 
PATCH 
PUT 
DELETE 


URI Pattern 
/products/:product_id/variants(.:format) 
/products/:product_id/variants(.:format) 
/products/:product_id/variants/new(.:format) 
/products/:product_id/variants/:id/edit(.:format) 
/products/:product_id/variants/:id(.:format 


format 


(. 
/products/:product_id/variants/:id(. 
/products/:product_id/variants/:id(. 

(. 


) 
format) 
) 
) 


/products/:product_id/variants/:id(.:format 


rails g scaffold variant product_id:integer price:decimal size 


在 运行 rails s 前 ， 记 得 要 更 新 数据 库 : 


rake db:migrate 


记得 ， 我 们 应 该 删除 routes 中 自动 添加 的 resources :variants ， 因 为 我 们 不 需要 在 
http://localhost:3000/variants 下 看 到 它 ， 不 是 么 ?2 我们 可 以 在 每 一 个 商品 (Product) 页 
面 ， 比 如 : http://localhost :3000/products/1 中 看 到 它 了 S 


2.3.3 路 由 中 的 命名 空间 (namespace) 


接 下 来 我 们 说 两 个 项 目 中 经 常会 见 到 的 情形 。 


Co 
var 
var 
var 
var 
var 
var 
var 


var 


一 个 项 目 ， 肯 定 要 有 admin 的 ， 我 们 如 何 把 管理 地 址 都 放 到 http://localhost:3000/admin/ 这 


个 目录 下 ? 


namespace :admin do 


resources :products 


end 


这 时 ， 这 样 就 足够 了 ， 不 过 ， 它 所 使 用 的 controller 和 view 是 在 admin 这 个 文件 夹 下 面 的 ， 
多 说 一 点 ， 它 的 controller 代码 也 是 在 Admin 这 个 module 下 的 。 如 果 你 还 对 Ruby 的 
module TÆ > RIAT T ° 


它 的 代码 是 : 


class Admin::ProductsController « ApplicationController 
end 


这 里 ， 我 们 反 过 来 想 ， 能 否 让 /admin/articles 下 的 代码 去 访问 ArticlesController ? 这 里 不 
再 是 Admin:: 开头 的 。 这 时 我 们 用 到 scope 


scope '/admin' do 
resources :articles 


end 


对 于 admin 下 的 资源 管理 ， 可 以 试 试 active admin 这 个 Gem © 


https://github.com/activeadmin/activeadmin 


2.3.4 concern 方法 
再 来 看 一 个 让 routes 更 简洁 ， 也 很 实用 的 方法 。 


concern :commentable do 
resources :comments 

end 

concern :image attachable do 
resources :images, only: :index 


end 


resources :messages, concerns: :commentable 
resources :articles, concerns: [:commentable, :image attachable] 


concern 定义 好 的 资源 ， 可 以 被 其 他 resource 里 多 次 引用 。 


Rails 的 原则 之 一 : 不 要 重复 自己 (Don't Repeat Yourself) 
2.3.5 有 用 的 参数 


:as 别名 
如 果 再 上 面 地 址 后 面 ， 加 上 as 参数 ， 会 直接 创建 一 个 别名 的 地 址 ， 比 如 


get 'home/welcome', as: :Welcome 


之 前 ， 我 们 在 views 或 者 controller 中 ， 连 接 到 或 跳 转 到 /home/index 可 以 这 么 

Ho home welcome path ? 增加 了 :as 后 ， 就 变 成 了 welcome path 了 。 好 处 是 ， 如 果 我 们 
某 一 天 更 改 了 对 应 的 action 甚至 controller， 这 个 写法 welcome path 是 不 会 变 的 ， 而 只 需要 
改动 routes 中 的 定义 。 


在 定义 routes 时 ， 要 注意 不 要 重复 定义 ， 因 为 : 写 在 上 面 的 会 覆盖 下 面 的 。 比 如 : 


get 'home/index', to: 'homeZwelcome' 
get 'home/index' 


访问 http://localhost:3000/home/index 会 进入 到 welcome 方法 中 。 
下 面 在 介绍 几 个 实用 的 参数 。 
shallow 


这 时 Rails 4 中 增加 的 一 个 很 实用 的 参数 。 


resources :products do 
resources :comments, shallow: true 
end 


它 把 index ^ new 和 create 方法 保留 在 了 products/:id 这 个 资源 下 ， 而 把 其 他 方法 ， 重 新 
放 回 到 /comments 下 。 这 样 的 考虑 是 避免 过 多 的 实用 襄 套 routes， 并 且 让 代码 更 简洁 。 


constraints 


我 们 可 以 给 routes 建立 约束 (Constraints) ， 比 如 : 


get 'photos/:id', to: 'photos#show', constraints: { id: /[A-Z]\d{5}/ } 


这 时 ，id 为 人 到 乙 开 头 ， 且 后 面 为 5 位 数字 的 id， 才 符合 路 由 条 件 ， 转 入 到 show 方法 。 而 


products/A123456 将 会 提示 No route matches 。 


2.3.6 Rspec 测试 


通常 ， 我 们 会 在 controller 中 写 上 测试 ， 不 过 Rspec 也 为 我 们 提供 了 测试 路 由 的 方法 。 我 们 
在 spec 下 建立 一 个 routing 文件 夹 ， 并 且 添 加 一 个 products routing spec.rb 的 文件 : 


RSpec.describe ProductsController, type: :routing do 
describe "routing" do 


it "routes to #index" do 
expect(:get -» "/products").to route to("productszindex") 
end 


我 们 为 它 单 独 运行 测试 ， 因 为 scaffold 自动 为 我 们 添加 的 测试 代码 ， 我 们 将 在 后 面 的 章节 
成 : 


ba 


% rspec spec/routing/products routing spec.rb 


routes 测试 的 参考 ， 可 以 查看 这 里 。 
好 了 ， 本 章 结束 了 ， 本 节 的 内 容 多 来 自 Rails 手册 中 的 Rails Routing from the Outside In， 你 
也 可 以 找到 在 这 里 找到 本 章 调试 的 代码 。 下 一 章 ， 我 们 将 开始 完成 shop 的 页 面 (views) 代 
码 ， 和 希望 它 可 以 让 你 更 加 了 解 Rails 。 


第 三 章 Rails 中 的 视图 


课程 概要 : 


本 课程 讲解 Rails 视图 (View) ， 内 容 包 括 常 用 的 辅助 方法 (Helper) ， 如 何 使 用 表单 
(Form) ，AJAX 在 视图 中 的 应 用 以 及 如 何 借 助 其 他 的 模板 引擎 实现 简洁 的 页 面 方案 。 


知识 点 : 


布局 
辅助 方法 
表单 
AJAX 
.模板 引擎 


om kwon a 


、 Ab 
TET X 
视图 (View) FP MVC 中 的 V， 也 是 Rails 使 用 者 最 先 见 到 的 部 分 。 在 完成 业务 逻辑 前 ， 合 理 


的 设计 视图 是 MVC 开发 中 最 先 得 到 用 户 认 可 的 部 分 。 本 课程 结合 商品 页 面 的 开发 ， 讲 解 
Rails 中 的 视图 。 


3.1 布局 和 辅助 方法 
概要 : 


本 课时 讲解 Rails 视图 (View) 中 的 布局 文件 ， 常 见 的 辅助 方法 (Helper) 以 及 如 何 使 用 局 部 
模板 。 


知识 点 : 


1. 布局 (layout) 
2， 辅 助 方法 (helper) 
3. 局 部 模板 (partial) 


EL 


3.1.1 布局 (layout) 
本 章 开 始 ， 我 们 将 进入 Rails 的 视图 (view) 的 开发 中 。 如 果 你 对 Rails 这 个 MVC 框架 还 有 
一 些 模糊 的 话 ， 建 议 读 一 读 这 篇 文章 。 

Rails 是 一 个 RESTful 风格 的 MVC 框架 。 
我 们 把 第 一 章 使 用 bootswatch 创建 的 项 目 copy 过 来 。 现 在 ， 我 们 进入 到 app/views 这 个 文 
件 夹 吧 。 


layouts 里 放 的 是 布局 文件 。 如 果 我 们 网 站 只 有 一 种 布局 ， 那 么 一 个 application.html.erb 
就 足够 了 。 我 们 也 可 以 为 每 个 资源 创建 一 个 layout ， 比 如 


app/views/layouts/products.html.erb ° 


我 们 删 掉 多 余 的 代码 ， 增 加 一 个 yield 的 辅助 方法 (helper) 。 


«div class="container"> 
<%= yield %> 
«/div» 


访问 我 们 的 页 面 ， 和 希望 你 会 看 到 和 我 一 样 的 效果 。 如 果 没 有 ， 没 关系 ， 可 以 到 这 里 clone 我 
们 的 代码 。 


Q' | [5 localhost:3000 NG 





Bootstrap theme Home About Contact Dropdown ~ 


Products 
Id Name Description Price Created at Actions 
1 haha hah 0.0 Fri, 20 Feb 2015 09:15:40 +0000 | Edit | Destroy | 


yield 方法 可 以 让 Rails 使 用 我 们 的 模板 (template) app/views/products/index.html.erb 
填充 了 布局 (layout) 。 


我 们 再 看 一 下 app/views/layouts/application.html.erb 中 的 这 一 外 


<%= yield(:page stylesheet) if content for?(:page stylesheet) %> 


如 果 我 们 在 app/views/products/index.html.erb 中 使 用 content for 方法 ， 可 以 在 这 个 
layout 的 这 个 位 置 ， 显 示 额 外 的 内 容 ， 比 如 ， 我 们 在 index.html.erb 的 最 上 面 增加 : 


<%= content for :page stylesheet do %> 
<!-- 这 是 index.html.erb 里 单独 使 用 的 --» 
<% end %> 


再 刷新 下 页 面 ， 我 们 在 源码 里 看 到 : 


18| <1link rel="stylesheet” media="all” nrer="/assets/sir 
19| «link rel="stylesheet" media="all" href="/assets/ove 





25 </head> 
26 <body> 


在 实践 开发 里 ， 我 们 经 常 这 样 做 : 布局 中 加 载 的 是 所 有 页 面 通用 的 内 容 和 css * js» MATH 
体 页 面 ， 就 通过 content for 这 个 辅助 方法 定义 自己 的 内 容 ， 在 我 们 的 
application.html.erb 里 ， 你 可 以 找到 四 个 content for ， 这 样 给 我 们 的 代码 里 增加 了 一 些 
灵活 ， 也 不 必 把 所 有 内 容 都 写 到 一 起 。 


content for? 判断 我 们 是 否定 义 了 这 个 变量 。 


如 果 我 们 想 更 改 一 下 布局 ， 该 如 何 做 呢 ? 实践 中 ， 我 们 的 确 会 遇 到 以 下 几 种 情形 : 


情形 一 : admin 要 使 用 自己 的 布局 文件 


app/views/layouts/admin.html.erb 


我 们 在 admin 的 controller 里 声明 它 使 用 另 一 个 : 


class AdminController < ApplicationController 
layout "admin" 


通常 我 们 把 admin 放 到 module 中 ， 而 为 admin 建立 一 个 通用 的 controller， 让 所 有 admin 
的 controller 都 继承 它 ， 这 样 ， 我 们 不 用 反复 的 去 定义 了 : 


class Admin::BaseController < ApplicationController 
layout "admin" 
end 


class Admin::ProductsController « Admin::BaseController 
end 


class Admin::CommentsController « Admin::BaseController 
end 


情形 二 : 为 完成 某 个 特殊 操作 ， 我 们 需要 更 改 布局 。 
这 时 ， 我 们 要 在 action 里 去 变更 这 个 布局 ， 比 如 ， 创 建 一 个 Product 的 时 候 : 


def new 

@product = Product.new 

render layout: "another layout" 
end 


def edit 
render layout: false 
end 


3.1.2 常用 的 辅助 方法 (helper) 


上 一 节 ， 我 们 已 经 使 用 了 几 个 辅助 方法 ， 这 里 我 们 再 介绍 几 个 Layouts and Rendering in 
Rails 提 到 的 helper ° 


link to 
你 会 发 现在 页 面 里 最 多 的 是 link to 这 个 方法 ， 它 的 参数 也 是 变 多 的 ， 我 们 来 详细 讲解 。 


我 们 把 现在 的 view 修改 一 下 ， 把 首页 的 链接 加 上 。 


<%= link to "网 店 演示 "，root_path, class: "navbar-brand" 965 


一 个 稍 复杂 的 例子 


<%= link to "删除 "，product， :method => :delete, :data => { :confirm => "点 击 确定 继续 " }, 
:class => 'btn btn-danger btn-xs' %> 


我 们 可 以 改变 link to 的 默认 行为 (GET) ， :method => :delete 将 发 送 delete 请 
Re :confirm 将 会 告诉 浏览 器 阻止 我 们 当前 的 动作 ， 直 到 点 击 确定 。 实 现 上 面 两 个 效果 ， 
需要 引入 ujs , 在 我 们 的 app/assets/javascripts/simplex.js [1] 中 已 经 为 我 们 引入 了 : 


//= require jquery 
//= require jquery_ujs 


注 [1] : 通常 我 们 使 用 的 是 application.js ， 但 是 在 1.3 中 我 们 设计 了 新 的 主题 ， 目 前 我 使 用 


的 是 simplex ° 


写 到 这 里 ， 我 要 推荐 http://api.rubyonrails.org/ 这 里 了 ， 对 于 各 种 Rails 本 身 的 方法 ， 我 们 可 
以 通过 查询 api 文档 得 到 。 如 果 是 某 个 Gem 提供 的 方法 ， 我 们 可 以 直接 翻 看 它 的 README 


或 者 代码 。 


一 个 较 实 用 的 工具 Dash， 可 以 帮 你 管理 每 个 版 本 api 文档 ， 查 询 起 来 也 很 方便 。 不 过 它 是 收 


费 的 。 
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link to(name = nil, options = nil, html options = nil, &block) 


Creates a link tag of the given name using a URL created by the set of options. See the valid 
options in the documentation for uri for. It's also possible to pass a String instead of an 
options hash, which generates a link tag that uses the value of the String as the href for the 
link. Using a :back Symbol instead of an options hash will generate a link to the referrer (a 
JavaScript back link will be used in place of a referrer if none exists). If nil is passed as the 
name the value of the link itself will become the name. 


Signatures 


link to(body, url, html options - ()) 
# url is a String; you can use URL helpers like 
# posts path 


link to(body, url options = (), html options = ()) 
f url options, except :method, is passed to url for 


link to(options - (), html options - ()) do 
# name 

end 

link to(url, html options - ()) do 
# name 

end 

Options 


* :data - This option can be used to add custom data attributes. 





image tag 


建议 你 使 用 api 文档 查找 一 下 这 方法 ， 你 会 看 到 这 个 代码 提示 : 


image tag("icon" 

# => «img alt-"Icon" src="/assets/icon" /> 

image tag("icon.png") 

# => «img alt-"Icon" src="/assets/icon.png" /> 

image tag("icon.png", size: "16x10", alt: "Edit Entry") 

# => «img src="/assets/icon.png" width="16" height="10" alt-"Edit Entry" /> 
image tag("/icons/icon.gif", size: "16") 

# => «img src-"/icons/icon.gif" width="16" height="16" alt="Icon" /> 
image_tag("/icons/icon.gif", height: '32', width: '32') 

# => <img alt="Icon" height="32" src="/icons/icon.gif" width="32" /> 
image_tag("/icons/icon.gif", class: "menu_icon" 

# => <img alt="Icon" class="menu_icon" src="/icons/icon.gif" /> 


我 们 的 图 片 是 来 自 app/assets/images 的 ， 我 放 了 一 个 logo.png 在 里 面 ， 你 会 发 现 它 的 地 
址 是 : http://localhost:3000/assets/logo-be2e3e66a18126c4042f84cd4aae4cb3.png ° Rails 使 用 
sprockets-rails 来 管理 app/assets 中 的 文件 ， 后 面 章 节 我 们 会 详细 介绍 。 


这 里 ， 我 们 可 以 关闭 be2e3e66a18126c4042f84cd4aae4cb3 这 种 形式 : 


config/environments/development.rb 


config.assets.digest - false 
重启 我 们 的 服务 ， 地 址 变 为 http://localhost:3000/assets/logo.png ° 


auto discovery link tag 


我 们 经 常 在 head 里 和 页 面 里 ， 增 加 rss fe atom 订阅 连接 ， 这 时 ， 我 们 可 以 使 用 
auto discovery link tag 这 个 辅助 方法 。 
<head> 
<%= auto discovery link tag(:rss, (controller: "products", action: "index"}, {title: " 
RSS Feed") 9 
<%= auto discovery link tag(:atom, (controller: "products", action: "index"}, {title: 


"ATOM Feed")) %> 


«/head» 


我 们 也 可 以 在 页 面 中 增加 这 个 连接 ， 这 在 web2.0 兴起 后 的 博客 中 很 常见 ， 方 便 我 们 把 数据 加 
入 到 订阅 中 。 


<%= link to "rss", products url(format: "rss") %> 
<%= link to "atom", products url(format: "atom") %> 


剩 下 的 问题 是 ，Rails 如 何 提供 这 个 数据 ， 我 并 不 想 等 到 controller 里 再 去 讲 这 个 部 分 ， 让 我 
们 现在 开始 了 解 下 : 


Rails 是 会 根据 我 们 的 请 求 类 型 ， 做 出 响应 。 


如 果 我 们 请 求 的 是 一 个 http://localhost:3000/products.html ，Rails 会 给 我 们 html 的 页 面 ， 
而 如 果 我 们 请 求 的 是 nttp://localhost:3000/products.rss ，Rails 会 自动 选择 rss YA) 7€ 
# (render) 后 返回 我 们 结果 。 http://localhost:3000/products.atom 也 是 一 样 。 所 以 ， 我 
们 在 app/views/products/ 中 增加 两 个 文件 : index.rss.builder 和 index.atom.builder 。 


在 controller 里 ， 如 果 我 们 想 对 结果 做 一 些 其 他 的 操作 ， 就 需要 增加 这 个 代码 : 


app/controllers/products controller.rb 


respond to do |format | 
format.html 
format.rss ( ... } 
format.atom { ... } 
end 


在 这 个 例子 中 ， 我 们 并 不 需要 改变 什么 ， 所 以 不 用 添加 它 。 


app/views/products/index.atom.builder 


atom feed do |feed| 
feed.title "商品 列表 " 
feed.updated @products.maximum( :updated_at) 


@products.each do |product| 
feed.entry product, published: product.updated at do |entry| 
entry.title product.name 
entry.content product.description 
entry.price product.price 
end 
end 
end 


app/views/products/index.rss.builder 


xml.instruct! :xml, version: "1.0" 
xml.rss version: "2.0" do 
xml.channel do 
xml.title "商品 列表 " 
xml.description "这 是 商品 列表 " 
xml.link products url 


@products.each do |product| 
xml.item do 
xml.title product.name 
xml.description product.description 
xml.price product.price 
xml.link product url(product) 
xml.guid product url(product) 
end 
end 
end 
end 


再 次 访问 http://localhost:3000/products.rss 和 http://localhost:3000/products.atom ， 你 
会 发 现 我 们 得 到 了 结果 。 


我 们 用 到 了 builder 这 个 结尾 的 文件 ， 它 会 告诉 Rails 使 用 Builder::xmlMarkup 这 个 库 
(lib) 来 解析 文件 。 所 以 看 rss.builder ， 它 是 按照 xml 格式 写 的 。 atom.builder MATH 
一 个 辅助 方法 atom feed ， 写 法 虽然 不 同 ， 但 是 生成 的 内 容 也 是 xml 格式 的 。 


在 scaffold 创建 的 文件 里 ， 你 会 看 到 index.json.jbuilder ? 它 会 使 用 JBuilder 这 个 库 来 
解析 并 生成 json 的 结果 。 这 会 在 后 面 的 章节 讲 到 ， 你 可 以 在 这 里 先 了 解 一 下 。 


Railscasts.com 是 所 有 Rails 学 习 者 必 看 的 网 站 ， 这 个 视频 一 定 会 帮助 你 理解 上 面 的 内 容 。 


在 此 ， 向 Ryan EX e 


stylesheet link tag 


«head» 
<%= stylesheet link tag "simplex", :media -» "all" 965 
</head> 


css 文件 的 引用 通常 放 到 页 面 的 head 标签 之 间 。 这 里 我 们 引用 的 是 css 文件 ， 我 们 也 可 以 
把 它 改 为 .css.scss ， 这 样 可 以 在 里 面 写 一 些 scss 语法 ， 而 不 用 更 改 我 们 的 引用 。 我 们 在 
2.1.3 中 已 经 提 到 了 scss 。 


javascript include tag 


<%= javascript include tag "simplex" 965 
<%= yield(:page javascript) if content for?(:page javascript) 96» 
«/body» 


浏览 器 是 自 上 而 下 解析 节点 元 素 (DOM) 的 ， 所 以 ， 请 注意 我 们 把 js 文件 加 载 放 到 页 面 最 
下 面 ， 以 免 因 为 菜 个 js 解析 问题 导致 页 面 始终 无 法 显示 。 在 引用 完 js 库 后 ， 我 们 还 可 以 根 
据 需 要 ， 单独 放置 页 面 的 :page javascript ° 


ActionView 还 为 我 们 提供 了 其 他 很 多 辅助 方法 ， 可 以 查看 这 里 。 


3.1.3 局 部 模板 (partial ) 


DRY, Don't Repeat Yourself. 不 要 重复 自己 。 
为 了 让 我 们 节省 更 多 的 页 面 重复 代码 ， 我 们 还 可 以 使 用 局 部 模板 (partial) 。 打 开 我 们 的 


app/views/products/index.html.erb 


<% @products.each do |product| 965 
<%= render partial: "product", locals: { product: product ) %> 
<% end %> 


这 里 我 们 使 用 了 局 部 模板 ， partial 指定 了 使 用 哪个 模板 ， locals 向 模板 里 传递 了 一 个 变 
量 。 在  product.html.erb 里 ， 我 们 显示 具体 product 的 信息 。 


不 过 这 是 一 个 老 套 的 写法 ，Rails 4 给 了 我 们 更 酷 的 写法 : 


<%= render Qproducts %> 


不 过 ， 如 果 需 要 传递 更 多 的 变量 (locals) ， 还 是 要 用 第 一 种 方法 ， 当 然 ， 你 完全 可 以 把 
each do 的 代码 放 到 局 部 模板 里 。 


我 们 也 可 以 不 传递 变量 到 局 部 模板 里 ， 它 可 以 找到 @products ， 看 一 下 new.html.erb 和 


edit.html.erb 
<%= render :partial => 'form' 965 
也 可 以 直接 写 : 


<%= render 'form' %> 


如 果 我 们 在 页 面 加 载 路 径 中 ， 放 置 了 多 个 同名 的 局 部 模板 ， 它 会 显示 离 它 最 近 的 那个 。 我 们 
可 以 把 公用 较 多 的 模板 ， 放 到 一 个 专属 的 文件 夹 里 ， 比 如 shared ， 引 用 的 时 候 : 


<%= render partial: "shared/product", locals: { product: product } %> 


i£: 当 使 用 locals 传递 参数 时 ， 一 定 要 声明 partial ° 


我 为 大 家 在 Shared 中 放置 了 一 个 同样 的 _product.html.erb ? 大 家 可 以 在 index.html.erb 
中 调用 看 看 。 


说 一 个 实践 中 经 常用 到 的 局 部 模板 。 


我 建立 了 一 个 新 的 文件 夹 application ， 这 里 会 放 布 局 文件 使 用 的 局 部 模板 ， 我 放 了 一 个 
_flash.html.erb ， 这 是 flash 通知 。 看 看 我 们 的 products controller.rb ， 我 们 在 操作 成 
功 后 会 有 提示 信息 ， 它 在 我 们 的 页 面 上 还 没有 显示 。 我 修改 了 一 下 application.html.erb 


<div class="container"> 
<%= render "flash" %> 
<%= yield %> 


为 了 让 flash 符合 bootstrap 的 格式 ， 我 做 了 代码 调整 ， 大 家 可 以 参考 代码 。 flash 是 
session 的 应 用 ， 通 常 在 controller 的 action 间 传 递 信息 ， 读 取 成 功 后 自动 清空 。 如 果 一 个 
flash 没有 在 合适 得 地 方 读 出 来 ， 那 么 它 将 被 保存 到 读 出 为 止 ， 这 会 造成 本 不 该 显示 它 的 地 方 
却 显示 它 ， 所 以 我 把 flash 放 到 了 layout 中 ， 使 得 所 有 页 面 都 会 引用 它 ， 保 证 它 产生 后 立 
刻 显示 ， 并 在 显示 后 自动 清空 。 


3.2 表单 
概要 : 


本 课时 讲解 Rails 如 何 通过 表单 (Form) 传递 数据 ， 以 及 表单 中 的 辅助 方法 使 用 ， 并 实现 登 
陆 注 册 功 能 。 


表单 中 的 辅助 方法 (helper) 
表单 绑 定 模型 (Model) 
注册 和 登录 


AOUN 


正文 
3.2.1 搜索 表单 (Form) 


如 果 我 们 的 表单 不 产生 某 个 资源 的 状态 改变 ， 我 们 可 以 使 用 GET 发送 表单 ， 这 么 说 很 抽象 ， 
比如 一 个 搜索 表单 ， 就 可 以 是 GET 表单 。 


我 们 在 页 面 的 导航 栏 上 ， 增 加 一 个 搜索 框 : 


<%= form tag(products path, method: "get") do %> 
<%= label tag(:q) %> 
<%= text field tag(:q) %> 
<%= submit tag("4£ k") 9 

<% end %> 


form tag 产生 了 一 个 表单 ， 我 们 设 定 它 的 method 是 get ， 它 的 action 地 址 是 
products path ， 我 们 也 可 以 设 定 一 个 hash 来 制定 地 址 ， 比 如 : 


form tag((action: "search"}, method: "get") do 


这 需要 你 在 products 里 再 增加 一 个 search 方法 ， 否则 ， 你 会 得 到 一 个 No route matches 
[:action-5 "search", :controller=>"products"} 的 提示 ， 这 告诉 我 们 3 form tag 的 第 一 个 参 
数 需要 是 一 个 可 解析 的 routes 地 址 。 当 然 ， 你 也 可 以 给 它 一 个 字符 串 ， 这 个 地 址 即便 不 存 


在 3: 也 不 会 造成 no route 提示 了 o 


form tag("/i/dont/know", method: "get") do 


这 并 不 是 我 们 最 终 的 代码 ， 我 们 还 需要 增加 一 些 附 加 的 属性 ， 让 我 们 的 式样 看 起 来 正常 一 
些 。 而 且 我 用 了 params[:q] 这 个 方法 ， 获 得 地 址 中 的 q 参数 ， 把 搜索 的 内 容 放 回 到 搜索 框 
中 o 


GC | D localhost:3000/products?utf8-y &q- a&commit-i$ 2 





《Rails 实 践 》 网 店 首页 ”我 的 订单 全 部 分 类 ~ a E3 HR. 注册 


商品 


rss atom 


Id 名 称 描述 价格 添加 日 期 Actions 
haha hah 0.0 2015 年 2 月 20 日 星期 五 17:15:40 ECG 

2 hhah haha 999.0 2015 年 2 月 23 日 星期 一 14:50:31 EC 

3 kk kk 88.0 2015 年 2 月 23 日 星期 一 15:57:37 caca 


我 们 可 以 在 controller €. > 44 M ActiveRecord 的 where 方法 查询 传 入 的 参数 ， 我 们 也 可 以 使 
用 (ransack)[https://github.com/activerecord-hackery/ransack] 这 种 gem 来 实现 搜索 功能 。 


ransack 是 一 个 metasearch 的 gem， 实 现 它 非常 的 方便 。 我 们 把 它 加 入 到 gemfile 里 : 


gem 'ransack' 


我 们 在 视图 里 ， 使 用 ransack 提供 的 辅助 方法 ， 来 实现 表单 : 


<%= search form for Qq, html: { class: "navbar-form navbar-left" } do |f| 9» 
«div class="form-group"> 
<%= f.search field :name cont, class: "form-control", placeholder: "输入 商品 名 称 " %> 
«/div» 
<% end %> 


提示 : 如 果 每 个 页 面 都 包含 这 个 搜索 框 ， 但 是 不 见得 每 个 页 面 都 有 @q 这 个 实例 ， 所 以 我 们 
可 以 自己 写 一 个 表单 ， 实 现 搜索 : 


<%= form tag products path, method: :get, class: "navbar-form navbar-left" do %> 
«div class="form-group"> 
<%= text field tag "q[name cont]", params["q"] && params["q"]["name cont"], class: 
"form-control input-sm search-form", placeholder: "输入 商品 名 称 " 9 
</div> 
<% end %> 


在 商品 的 controller 中 ， 我 们 修改 index 方法 : 


def Index 
Qq = Product.ransack(params[:q]) 
@products = @q.result(distinct: true) 
end 


好 了 ， 一 个 简单 的 查询 实现 了 。 这 里 我 们 使 用 的 是 name cont 来 实现 模糊 查询 ， 文 档 上 提供 
了 详尽 的 方法 ， 实 现 更 复杂 的 查询 。 


3.2.2 常用 的 表单 辅助 方法 
在 我 们 使 用 form tag 的 同时 ， 我 们 还 需要 一 些 辅助 方法 来 生成 表单 控件 。 


<%= text area tag(:message, "Hi, nice site", size: "24x6") %> 
<%= password field tag(:password) %> 

<%= hidden field tag(:parent id, "5") 965 

<%= search field(:user, :name) %> 

<%= telephone field(:user, :phone) %> 

<%= date field(:user, :born on) %> 

<%= datetime field(:user, :meeting time) 965 

<%= datetime local field(:user, :graduation day) %> 

<%= month field(:user, :birthday month) 965 

<%= week field(:user, :birthday week) %> 

<%= url field(:user, :homepage) %> 

<%= email field(:user, :address) %> 

<%= color field(:user, :favorite color) %> 

<%= time field(:task, :started at) %> 

<%= number field(:product, :price, in: 1.0..20.0, step: 0.5) %> 
<%= range field(:product, :discount, in: 1..100) %> 


解析 后 的 代码 是 : 


«textarea id="message" name="message" cols="24" rows="6">Hi, nice site</textarea> 
<input id="password" name="password" type="password" /> 

«input id-"parent id" name="parent_id" type="hidden" value="5" /> 

«input id="user_name" name="user[name]" typez"search" /> 

<input id="user_phone" name="user[phone]" type="tel" /> 

<input id="user_born_on" name="user[born_on]" type="date" /> 

<input id="user_meeting_time" name="user[meeting_time]" type="datetime" /> 

<input id="user_graduation_day" name="user[graduation_day]" type="datetime-local" /> 
<input id="user_birthday_month" name="user[birthday_month]" type="month" /> 

«input id-"user birthday week" name-"user[birthday week]" type="week" /> 

«input id-"user homepage" name="user[homepage]" type-"url" /> 

«input id-"user address" name-"user[address]" type="email" /> 

«input id-"user favorite color" name="user[favorite_color]" type-"color" value- "#00000 
O" /> 

«input id-"task started at" name-"task[started at]" type="time" /> 

«input id-"product price" max="20.0" min="1.0" name="product[price]" step="0.5" type=" 
number" /> 

«input id-"product discount" max="100" min="1" name="product[discount]" type="range" / 
> 


更 多 的 表单 辅助 方法 ， 建 议 大 家 直接 查看 这 个 部 分 的 源 代码 ， 我 一 直 认 为 源 代 码 是 最 好 的 教 
材 。 
3.2.3 模型 (Model) 的 辅助 方法 


我 们 还 可 以 使 用 不 带 有 ta 结尾 的 辅助 方法 ， 来 显示 一 个 模型 (Model) 实例 
(Instance) ， 比 如 我 们 的 @product ， 可 以 在 它 的 编辑 页 面 中 这 样 来 写 : 


<%= text field(:product, :name) %> 


他 会 给 我 们 


vu 


<input type="text" value=" WRA æ" name="product[name]" id="product_name"> 


它 接受 两 个 参数 ， 并 把 它 拼 装 成 product[name] ， 并 且 把 value 赋予 这 个 属性 的 值 。 我 们 提 
交 表 单 的 时 候 ，Rails 会 把 它 解释 成 product: (name: ' 测 试 商品 '，...} ， 这 
样 ， Product.create(...) 可 以 添加 这 个 商品 信息 到 数据 库 中 了 。 


不 过 这 样 做 会 有 个 问题 ， 这 个 商品 会 有 很 多 属性 需要 我 们 填写， 会 让 代码 变 得 “ 嘿 哑 ”"。 这 时 ， 
我 们 可 以 把 这 个 实例 ， 绑 定 到 表单 上 。 

注 : 说 模型 对 象 ， 通 常 指 Product 这 个 模型 ， 说 模型 实例 ， 指 @product 。 一 些 文档 上 并 不 
区 分 这 种 称呼 ， 个 人 觉得 容易 混淆 。 


3.2.4 把 模型 (Model) 绑 定 到 表单 上 
来 看 看 我 们 的 商品 添加 界面 使 用 的 表单 吧 ， 它 在 这 里 app/views/products/. form.html.erb 


<%= form for @product, :html => { :class => 'form-horizontal' } do |f| %> 


这 里 我 们 用 了 form for 这 个 方法 ， 它 可 以 将 一 个 资源 和 表单 绑 定 ， 这 里 我 们 将 controller 
中 的 @product 和 它 绑 定 。 form for. 会 判断 @product 是 否 为 一 个 新 的 实例 (你 可 以 看 看 
@product .new_record? ) ， 从 而 将 form 的 地 址 指向 create 还 是 update 方法 ， 这 是 符合 
我 们 之 前 提 到 的 REST 风格 。 


当然 ， 大 多 数 浏览 器 是 不 支持 PUT ^ PATCH ^ DELETE 方法 的 ， 浏 览 器 在 提交 表单 时 ， 只 会 
是 GET 或 post ， 这 时 ，form_tag 会 创建 一 个 隐藏 空间 ， 来 告诉 Rails 这 是 一 个 什么 动作 。 
而 form for 会 根据 实例 ， 来 自动 判断 。 


«input name-" method" type="hidden" value="patch" /> 


在 我 们 显示 商品 属性 的 时 候 ， 用 到 了 f.text field :name 这 个 辅助 方法 ， 这 样 ， 我 们 不 用 再 
为 每 一 个 text field 去 声明 这 是 哪个 实例 了 。 f 是 一 个 表单 构造 器 (Form Builder) 3: 
例 ， 你 可 以 在 这 里 看 到 更 多 它 的 介绍 。 


我 们 可 以 自己 定义 FormBuilder ， 以 节省 更 多 的 代码 ， 也 可 以 使 用 simple form > formtastic 
这 种 Gem。 推 荐 ruby-toolbox.com 这 个 网 站 ， 你 可 以 发 现 其 他 的 好 用 的 Gem » 


3.2.5 注册 和 登录 


现在 ， 我 们 实现 一 个 很 重要 的 功能 ， 注 册 和 和 登录。 我 们 不 需要 从 头 实现 它 ， 因 为 我 们 有 Rails 
十 大 必 备 Gem 中 的 第 一 位 : Devise 可 以 选择 。 


在 Gemfile 中 增加 


gem 'devise' 


在 bundle install 之 后 ， 我 们 需要 创建 配置 文件 : AP (User) 


96 rails generate devise:install User 
create config/initializers/devise.rb 
create config/locales/devise.en.yml 


Some setup you must do manually if you haven't yet: 

1. Ensure you have defined default url options in your environments files. Here 
is an example of default url options appropriate for a development environment 
in config/environments/development.rb: 

config.action mailer.default url options = ( host: 'localhost', port: 3000 } 


In production, :host should be set to the actual host of your application. 


2. Ensure you have defined root url to *something* in your config/routes.rb. 
For example: 


root to: "home#index" 


3. Ensure you have flash messages in app/views/layouts/application.html.erb. 
For example: 


«p class- notice 5X#- notice %></p> 
«p class="alert"><%= alert %></p> 


4. If you are deploying on Heroku with Rails 3.2 only, you may want to set: 
config.assets.initialize on precompile - false 


On config/application.rb forcing your application to not access the DB 
or load models when precompiling your assets. 


5. You can copy Devise views (for customization) to your app by running: 


rails g devise:views 


之 后 ， 我 们 创建 用 户 (User) 模型 : 


96 rails generate devise User 
invoke active record 
create db/migrate/20150224071758 devise create users.rb 





create app/models/user.rb 

invoke test unit 

create test/models/user test.rb 
create test/fixtures/users.yml 
insert app/models/user.rb 


route devise for :users 


之 后 ， 我 们 创建 用 户 (User) 需要 的 views 


% rails g devise:views 
invoke Devise::Generators: :SharedViewsGenerator 


create app/views/users/shared 

create app/views/users/shared/ links.html.erb 

invoke form for 

create app/views/users/confirmations 

create app/views/users/confirmations/new.html.erb 

create app/views/users/passwords 

create app/views/users/passwords/edit.html.erb 

create app/views/users/passwords/new.html.erb 

create app/views/users/registrations 

create app/views/users/registrations/edit.html.erb 

create app/views/users/registrations/new.html.erb 

create app/views/users/sessions 

create app/views/users/sessions/new.html.erb 

create app/views/users/unlocks 

create app/views/users/unlocks/new.html.erb 

invoke erb 

create app/views/users/mailer 

create app/views/users/mailer/confirmation instructions.html.erb 
create app/views/users/mailer/reset password instructions.html.erb 
create app/views/users/mailer/unlock instructions.html.erb 


最 后 ， 更 新 db : 


rake db:migrate 


在 使 用 注册 登录 功能 前 ， 我 们 修改 一 下 布局 页 面 ， 增 加 几 个 链接 : 


<% if user signed in? %> 

<li><%= link to current user.email, profile path %></1li> 

<li><%= link to "ik", destroy user session path, method: :delete %></li> 
<% else %> 

<li><%= link to "&#", new user session path %></1li> 

«li»«*- link to "i€A4t", new user registration path *X»«/li» 
<% end %> 


现在 ， 我 们 可 以 使 用 注册 登录 功能 了 ， 是 不 是 很 简单 呢 ? 


接 下 来 ， 我 们 对 Devise 创建 的 页 面 做 一 点 修改 ， 同 时 看 看 Rails 如 何 实 现 表 单 的 。 


我 们 登录 界面 在 app/views/users/sessions/new.html.erb ， 我 们 把 它 改 一 下 ， 符 合 我 们 页 面 风 
格 ， 具 体 如何 使 用 html 代码 ， 可 以 参考 http://bootswatch.com/simplex/ ° 


本 章 的 代码 在 这 里 ， 和 希望 可 以 帮助 大 家 理解 表单 和 其 使 用 。 


表单 
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3.3 视图 中 的 AJAX 交互 


概要 : 


本 课时 通过 对 商品 的 添加 、 编 辑 和 删除 ， 讲 解 视 图 中 如 何 使 用 UJS > jQuery 和 JSON， 实 现 
无 刷新 情况 下 的 页 面 更 新 。 


知 qui AAAN 


1. jQuery 
2. UJS 

3. AJAX 
4. JSON 


ET 
c ia: OM LU Nd RUE M cere A a ELE 
服务 器 发 起 一 个 请 求 ， 服 务 器 返 给 我 们 结果 ， 查 看 源 代码 ， 它 是 一 篇 HTML 的 代码 。 


我 们 每 次 请 求 一 个 地 址 ， 都 会 给 我 们 完整 的 HTML 结果 ， 对 于 内 容 较 少 的 网 页 ， 传 输 起 来 还 
是 很 快 的 ， 但 是 对 于 内 容 多 的 网 页 ， 大 篇 的 结果 自然 会 拖 慢 页 面 显 示 。 


当 我 们 浏览 页 面 的 时 候 ， 并 不 期 望 总 是 刷新 整个 页 面 ， 因 为 它 没 必 要 。 现 在 我 们 有 ajax 技 
术 ， 可 以 只 加 载 和 显示 部 分 页 面 代 码 。 举 个 简单 的 例子 : 当 我 们 提交 了 一 条 评论 ， 页 面 上 自 
动 显示 出 我 们 提交 的 评论 内 容 。 我 们 点 击 购买 按钮 ， 页 面 上 就 提示 我 们 购物 车 里 增加 了 一 个 
商品 。 而 这 些 ， 都 不 必要 刷新 整个 页 面 。 


ajax 是 Asynchronous Javascript And XML 的 缩写 ， 含 义 是 异步 的 js 和 XML 交互 技术 。 
XML， 可 扩展 标记 语言 ， 我 们 使 用 的 HTML 是 基于 其 发 展 起 来 的 。 


下 面 我 们 看 下 Rails 是 如 何 把 ajax 技术 应 用 在 视图 (View) 中 的 。 


3.3.1 ujs 


我 们 在 Gemfile 中 已 经 使 用 了 gem 'jquery-rails' 这 个 Gem， 它 可 以 让 我 们 在 
application.js 中 增加 这 两 行 : 


//= require jquery 
//= require jquery_ujs 


jQuery 是 一 个 轻 量 级 的 js 库 ， 可 以 方便 的 处 理 HTML， 事 件 〈Event) ， 动 态 效果 ， 为 页 面 提 


供 ajax X Z ° jQuery 有 很 完善 的 文档 及 演示 代码 ， 以 及 大 量 的 插件 。 


Rails 使 用 一 种 叫 ujs (Unobtrusive JavaScript) 的 技术 ， 将 js 应 用 到 DOM 上。 我 们 来 看 一 





个 例子 : 
€ 3 Q' [5 localhost:3000 GE 
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我 们 已 经 给 删除 连接 增加 了 两 个 属性 : 


<%= link to "删除 "，product， :method => :delete, :data => { :confirm => "点 击 确定 继续 " } 
%> 


来 看 看 我 们 的 HTML : 


«a data-confirm=" 点 击 确定 继续 " rel="nofollow" data-method="delete" href="/products/1">#] 
除 </a> 


辅助 方法 link to 使 用 了 :data => { :confirm => "点 击 确定 继续 " } 这 个 属性 ， 为 我 们 添加 了 
data-confirm=" 点 击 确定 继续 " 这 样 的 HTML 代码 ， 之 后 Ujs 将 它 处 理 成 一 个 弹出 框 。 


在 删除 按钮 上 ， 还 有 method => :delete 属性 ， 这 为 我 们 的 连接 上 增加 了 data- 
method-"delete" 属性 ， 这 样 ，Ujs 会 把 这 个 点 击 动作 ， 会 发 送 一 个 delete 请 求 删除 资源 ， 
这 是 符合 REST 要 求 的 。 


我 们 可 以 给 a 标签 增加 data-disable-with 属性 ， 当 点 击 它 的 时 候 ， 使 它 禁 用 ， 并 提示 文 
字 信 息 。 这 样 可 以 防止 用 户 多 次 提交 表单 ， 或 者 重复 的 链接 操作 。 


我 们 为 商品 表单 中 的 按钮 ， 增 加 这 个 属性 : 


<%= f.submit nil, :data => ( :"disable-with" => "请 稍 等 ..." } %> 
当 我 们 提交 表单 时 ， 会 有 : 


创建 商品 


名 称 
测试 


描述 
测试 


价格 
9.99 


取消 
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如 果 你 还 没 看 清楚 效果 ， 页 面 就 已 经 跳 转 了 ， 我 们 可 以 给 create 方法 增加 一 个 sleep 10 : 


def create 
sleep 10 
@product = Product.new(product params) 


更 多 ujs 支持 的 属性 ， 我 们 在 这 里 看 到 。 


3.3.2 无 刷新 页 面 的 操作 


ujs 给 我 们 带 来 的 一 些 便利 还 不 止 这 些 ， 我 们 来 点 复杂 的 : 在 不 刷新 页 面 的 情形 下 ， 添 加 一 个 
商品 ， 并 显示 在 列表 中 。 


我 们 现在 的 列表 页 是 这 样 的 : 


视图 中 的 AJAX 交互 


O localhost:3000 
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商品 


rss atom 
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现在 点 击 添加 ， 我 们 会 进入 到 http://localhost:3000/products/new ， 我 们 并 不 改变 它 ， 毕 竟 
在 某 些 js 失效 的 情形 下 ， 点 击 这 个 按钮 还 是 要 跳 转 到 new 页 面 的 。 


我 们 希望 给 页 面 增加 一 个 表单 ， 来 输入 新 商品 的 信息 ， 在 这 之 前 ， 我 们 想 更 酷 一 点 ， 我 们 使 
用 modal 来 显示 这 个 表单 : 


<%= link to t('.new', :default => t("helpers.links.new")), new product path, :class => 
"btn btn-primary', data: (toggle: "modal", target: "#productForm"} 96» 


ujs 允许 我 们 在 link 上 增加 额外 的 属性 ， 当 我 们 再 次 点 击 添加 按钮 时 : 





[ [5 localhost:3000 





当然 我 做 了 其 他 一 些 修 改 ， 你 可 以 在 过 里 找到 完整 的 代码 。 


为 了 产生 一 个 ajax 的 请 求 ， 我 们 在 表单 上 增加 一 个 参数 remote: true 
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<%= form for @product, remote: true, :html => { :class => 'form-horizontal' } do |f| % 
> 


这 时 ， Ujs 将 会 调用 jQuery.ajax() 提交 表单 ， 此 时 的 请 求 是 一 个 text/javascript 请 求 ? 
Rails 会 返回 给 我 们 相应 的 结果 ， 在 我 们 的 action 里 ， 增 加 这 样 的 声明 : 


respond to do |format | 
if @product.save 
format.html {...} 
format.js 
else 
format.html {...} 
format.js 
end 
end 


在 保存 (save) 成 功 时 ， 我 们 返回 给 视图 (view) 一 个 js 片段 ， 它 可 以 在 浏览 器 端 执 行 。 


我 们 创建 一 个 新 文件 app/views/products/create.js.erb ， 在 这 里 ， 我 们 将 新 添加 商品 ， 显 示 
在 上 面 的 列表 中 。 


$('#productsTable').prepend('<%= j render(@product) %>'); 
$('£2productFormModal').modal('hide'); 
我 们 使 用 .js.erb 的 文件 ， 方 便 我 们 在 js 文件 里 插入 erb 的 语法 。 


我 们 将 一 行商 品 信息 使 用 prepend 方法 ， 插 入 到 productsTable 的 最 上 面 ，j 方法 将 我 们 
的 字符 串 转 换 成 js 片段 。 


好 了 ， 你 可 以 试 一 斌 效果 了 。 


你 可 能 也 像 我 一 样 做 了 一 些 测试 ， 导 致 插入 了 很 多 测试 数据 ， 为 了 继续 不 刷新 页 面 就 完成 删 
除 操作 ， 我 们 给 删除 按钮 上 也 增加 一 个 ajax MA o 


我 们 先 给 每 一 行 记 录 ， 增 加 一 个 唯一 的 ID 标识 ， 通 常 使 用 "名 字 + i 中 的 形式 ， 我 们 还 需要 给 
删除 连接 增加 remote: true 属性 ， 我 们 编辑 app/views/products/ product.html.erb 


«tr id="product_<%= product.id 965 "5 


<%= link to "Wi", product, :method => :delete, remote: true, :data => ( :confirm => " 
点 击 确定 继续 " }, :class => 'btn btn-danger btn-xs' %> 


我 们 再 增加 一 个 文件 以 返回 js 片段 给 浏览 器 执行 app/views/products/destroy.js.erb 


$('#product_<%= @product.id %>').fadeOut(); 


你 可 以 再 试 试看 。 
现在 ， 我 们 看 一 下 添加 商品 时 的 返回 结果 : 


$('#productsTable').prepend('<tr id=\"product_14\">\n <td><a href=\"/products/14\">kk 
k<\/a><\/td>\n <td>jjj<\/td>\n <td class=\"text-right\">CN¥ 999.00<\/td>\n <td>2015 
年 2 月 26 日 星期 四 23:57:55<\/td>\n <td>\n «a class=\"btn btn-primary btn-xs\" href=\" 
/products/14/edit\">%4##<\/a>\n «a data-confirm=\" 点 击 确定 继续 \" class=\"btn btn-dange 
r btn-xs\" data-remote=\"true\" rel=\"nofollow\" data-method=\"delete\" href=\"/produc 
ts/14\"> 删 除 <\Va>\n <\/td>\n<\/tr>\n'); 

$('sproductFormModal').modal('hide'); 


这 里 面 大 部 分 代码 是 不 必要 的 Haad 如 何 让 我 们 的 返回 结果 更 简洁 呢 ? 我 们 现在 发 送 


个 是 text/javascript 请 求 ， 返 回 给 我 们 的 是 js 片段 。 下 一 节 puse # 'json' 请 求 ， 我 们 在 
浏览 器 端 使 用 js 处 理 返 回 的 json d o 


3.3.3 json 数据 的 页 面 处 理 


为 了 和 添加 商品 区 分 开 ， 我 们 在 修改 商品 时 ， 使 用 json 来 处 理 数据 ， 而 且 也 在 一 个 modal 
中 完成 。 


<%= link to t('.edit', :default => t("helpers.links.edit")), edit product path(product 


), remote: true, data: ( type: 'json' }, :class => 'btn btn-primary btn-xs editProduct 
Link' 965 


我 们 给 编辑 链接 ， 增 加 了 remote: true, data: { type: 'json' } ， 这 时 我 们 没有 打 
JF modal ， 我 们 把 js 代码 写 在 coffeescript 中 。 


我 们 新 建 一 个 文件 ， app/assets/javascripts/products.coffee 。 这 个 文件 我 们 只 在 商品 页 面 
使 用 ， 所 以 不 必 把 它 放 到 simplex.js 中 ， 现 在 我 们 只 在 商品 的 index.html.erb 中 使 用 它 ， 
所 以 : 


<%= content for :page javascript do %> 
<%= javascript include tag "products" 9 


当 我 们 点 击 编辑 按钮 时 ， 我 们 期 望 几 件 事 : 


1. 打开 modal 层 ， 显 示 编 辑 表 单 
读 取 这 个 商品 的 信息 (json 格式 ) ， 把 需要 编辑 的 内 容 境 入 表单 


好 ， 我 们 写 上 这 部 分 代码 : 


jQuery -> 
$(".editProductLink") 

,On "ajax:success", (e, data, status, xhr) -> 
S('#alert-content').hide() [1] 
S('#editProductFormModal').modal('show') [2] 

S('#editProductName' ).val(data['name']) [3] 
$('#editProductDescription').val(data['description']) [3] 
$('#editProductPrice').val(data['price']) [3] 
$("#editProductForm").attr('action', '/products/'+data['id']) [4] 


[1] 我 们 隐藏 错误 信息 提示 框 
[2] 显示 层 

[3] 卉 入 编辑 的 信息 

[4] 更 改 表单 提交 的 地 址 


再 来 看 看 我 们 的 编辑 表单 : 


<%= form tag "", method: :put, remote: true, data: { type: "json" }, id: "editProductF 
orm", class: "form-horizontal" do %> 


<%= text field tag "product[name]", "", :class => 'form-control', id: "editProductName 
", required: true #5 


<%= text field tag "product[description]", "", :class => 'form-control', id: "editProd 
uctDescription" %> 


<%= text field tag "product[price]", "", :class => 'form-control', id: "editProductPri 


ce" 9» 


我 们 让 表单 提交 的 地 址 ， 可 以 根据 选择 的 商品 而 改变 ， 同 时 我 们 设 定 它 的 type 为 json 格式 。 


我 们 为 每 一 个 输入 框 ， 设 定 了 ID， 这样 ， 我 们 用 读 取 的 json 信息 ， 分 别 填 入 对 应 的 编辑 杠 
内 。 


然后 ， 我 们 改动 一 下 controller 中 的 方法 : 


def edit 
respond to do |format 
format.html 
format.json ( render json: @product, status: :ok, location: @product } [1] 
end 
end 


e [1] 我 们 让 edit 方法 ， 返 回 给 我 们 商品 的 json 格式 信息 。 


def update 
respond to do |format | 
if @product.update(product params) 
format.html ( redirect to @product, notice: 'Product was successfully updated.' 


format.json [1] 
else 
format.html { render :edit } 
format.json ( render json: Qproduct.errors.full messages.join(', '), status: :er 
ror } [2] 
end 
end 
end 


e [1] 我 们 让 update 方法 ， 可 以 接受 json 的 请 求 ， 
。[2] 当 update RRM > RN SLAM YR MSE PGR > SHE json 格式 的 。 


当 我 们 需要 考虑 update 方法 会 有 成 功 和 失败 两 种 可 能 时 ， 我 们 的 ajax 调用 ， 就 要 这 样 来 写 
Jes 


$("#editProductForm" ) 

,On "ajax:success", (e, data, status, xhr) -> 
$('£editProductFormModal').modal('hide') [1] 
$('#product_'tdata['id']+'_name').html( data['name'] ) [2] 
$('#product_'t+tdata['id']+'_description').html(  data['description'] ) [2] 
S('#product '«data['id']*' price').html( data['price'] ) [2] 

.on "ajax:error", (e, xhr, status, error) -» 
$('#alert-content').show() [3] 
$('#alert-content Zmsg').html( xhr.responseText ) [4] 


e [1] 我 们 隐藏 这 个 层 
e [2] 当成 功 的 时 候 ， 我 们 把 修改 好 的 信息 ， 放 回 到 我 们 的 页 面 中 
e [3] 当 失 败 的 时 候 ， 我 们 显示 个 错误 信息 提示 框 


[4] 我 们 向 这 个 框 内 ， 填 入 信息 


更 多 controller 的 介绍 ， 后 面 章 节 还 会 有 ， 这 里 我 们 要 了 解 的 是 ， 我 们 页 面 拿 到 的 信息 ， 不 再 
是 js 片段， 而 是 json 格式 的 数据 。 


当 我 们 处 理 大 量 数据 的 时 候 ，json 明显 要 比 js 片段 更 节省 传输 空间 ， 我 们 也 可 以 把 处 理 动作 
写 到 独立 的 js 文件 中 ， 不 过 ，json 格式 返回 给 我 们 的 ， 是 9.9， 而 我 们 页 面 显示 的 是 格式 化 
后 的 cny 9.90 ， 如 果 我 们 想 把 处 理 好 格式 的 数据 返还 回来 ， 该 如 何 处 理 呢 ? 


我 们 可 以 使 用 jbuilder 做 这 件 事 ， 我 们 新 建 一 个 update.json.jbuilder 


json.id @product.id 

json.name link to @product.name, product path(@product) [1] 
json.description @product.description 

json.price number to currency(@product.price) [2] 


e [1] 我 们 把 链接 的 地 址 用 辅助 方法 生成 

e [2] 我 们 用 number to currency 方法 把 价格 格式 化 ， 这 里 可 以 使 用 辅助 方法 
如 何 知 道 我 们 的 确 使 用 的 是 json 数据 呢 ? 我 们 可 以 查看 浏览 器 的 控制 台 ， 或 者 查看 命令 行 的 
log 输出 。 





Q [] Elements|Network| Sources Timeline Profiles Resources Audits Console 








[] ES 7 = O Preserve log G Disable cache - 


lame Status asa Size 
‘ath Method Text Type Initiator Conte: 
“| k3k702ZOKiLJc3WVjuplzBampu5, 7CjHW5spxoeN3Vs.woff2 304 localhost/:1 
a GET font/woff2 
fonts.gstatic.com/s/opensans/v10 Not Modified Parser 1 


po EU sd SUE ES nra SETS 
al POST Ed application/json — hatys lo. 
Started GET "/products/28/edit" for ::la 9015-03-01 01:15:43 +0800 
Processing by ProductsController#edit fas JSON 

Parameters: {"id"=>"28"} 

User Load (0.2ms) SELECT "users".* FROM "users" WHERE "users"."id" = ? ORDER 


Product Load (9.2ms) SELECT "products".* FROM "products" WHERE “products"."id 
Completed 200 OK in 4ms (Views: 0.9ms | ActiveRecord: 0.4ms) 


Started PUT "/products/28" for ::1 at [20 93-01[01:15:44 +0800 
Processing by ProductsController#upda e as JSON | 
Parameters: {"utf8"=>"v", "product" 哈哈 哈哈 太 好 了 "，"description"=> 
User Load (6.lms) SELECT  "users".* FROM "users" WHERE "users"."id" = ? ORDER 
Product Load (8.1ms) SELECT “products".* FROM "products" WHERE "products"."id 
(8.1ms) begin transaction 
(8.1ms) commit transaction 
Rendered products/update.json.jbuilder (0.9ms) 


poe 200 OK in 21ms (Views: 14.9ms | ActiveRecord: 0.4ms) 


在 过 里 可 以 找到 我 调试 好 的 代码 。 


在 实践 开发 中 ， 我 们 会 从 服务 端 拿 到 很 多 的 内 容 ， 比 如 几 十 条 订单 信息 ， 我 们 可 以 用 上 面 的 

方法 把 它们 显示 到 页 面 上 ， 也 可 以 使 用 http://handlebarsjs.com/ 这 种 模板 引擎 ， 使 页 面 和 逮 

辑 更 加 的 独立 ， 清 蜥 。 当 我 们 面 对 少量 的 内 容 时 ，js 片段 要 比 写 一 大 堆 coffeescript 来 的 更 省 
事 些 。 所 以 ， 我 们 在 确定 选用 哪 种 方式 处 理 ， 要 看 我 们 面 对 的 是 怎样 的 问题 。 


最 后 附 上 两 个 附 表 。 


附 表 一 ， 当 我 们 render json:..., status: :ok, ... Hi > status 和 符号 的 对 应 ， 可 以 在 这 里 
找到 ， 一 般 我 们 用 :ok, :create, :success, :error 就 足够 了 。 


Response Class HTTP Status Code Symbol 


Informational 100 :continue 
101 :switching protocols 
102 :processing 
Success 200 :OK 
201 :created 
202 :accepted 
203 :non authoritative information 
204 :no content 
205 :reset content 
206 :partial content 
207 :multi status 
208 :already reported 
226 iim used 
Redirection 300 :multiple choices 
301 :moved permanently 
302 :found 
303 :see other 
304 :not modified 
305 :use proxy 
306 :reserved 
307 temporary redirect 
308 :permanent redirect 
Client Error 400 :bad request 
401 :unauthorized 
402 :payment required 
403 :forbidden 
404 :not found 
405 :method not allowed 
406 :not acceptable 
407 :proxy authentication required 


408 :request timeout 


Server Error 


409 
410 
411 
412 
413 
414 
415 
416 
417 
422 
423 
424 
426 
428 
429 
431 
500 
501 
502 
503 
504 
505 
506 
507 
508 
510 
511 


:conflict 

:gone 

:length_required 
:precondition_failed 

:request entity too large 
:request uri too long 
:unsupported media type 
:requested range not satisfiable 
:expectation failed 
:unprocessable entity 
‘locked 

‘failed_dependency 
:upgrade required 
:precondition required 

:too many requests 

:request header fields too large 
internal server error 

:not implemented 

:bad gateway 

:service unavailable 
:gateway timeout 

:http version not supported 
variant also negotiates 
insufficient storage 

loop detected 

:not extended 


:network authentication required 


附 表 二 : ajax 的 回调 方法 ， 我 们 使 用 了 :success 和 :error， 当 然 还 有 其 他 的 一 些 ， 我 们 需要 


了 解 下 。 


ajax 


ajax 


ajax 


ajax 


ajax 


ajax 


ajax 


ajax 


event name 


:before 


:beforeSend 


:send 


:Success 


:error 


:complete 


:aborted:required 


:aborted:file 


extra 
parameters 
* 


[event, xhr, 
settings] 


[xhr] 


[data, 
status, xhr] 


[xhr, status, 
error] 


[xhr, status] 
[elements] 


[elements] 


when 


before the whole ajax business , aborts if 
stopped 


before the request is sent, aborts if stopped 


when the request is sent 


after completion, if the HTTP response was a 
success 


after completion, if the server returned an 
error ** 


after the request has been completed, no 
matter what outcome 


when there are blank required fields in a 
form, submits anyway if stopped 


if there are non-blank input:file fields in a 
form, aborts if stopped 


3.4 模板 引擎 的 使 用 
概要 : 


本 课时 结合 商品 页 面 ， 讲 解 如 何 使 用 简洁 安全 的 模板 引擎 ， 以 及 如 何 更 改 邮件 模板 。 


Fate m o: 


haml 
slim 
liquid 
邮件 模板 


ome 


EX 


3.4.1 hamil 


前 面 的 章节 里 ， 我 们 一 直 使 用 eb 作为 视图 模板 ，erb 可 以 让 我 们 在 html T FA Ruby 4X 
码 。 这 样 做 的 好 处 是 ， 我 们 拿 到 的 页 面 和 设计 师 提 供 的 页 面 几乎 无 任何 差别 ， 可 以 直接 增加 
ERNA Ruby 写 的 的 逻辑 。 稍 微 不 好 的 一 点 是 ，html 太 多 了 ， 稍 微 处理 不 好 ， 会 缺失 标 
签 ， 而 且 不 易 察 觉 。 


这 时 我 们 可 以 使 用 其 他 一 些 方案 ，haml 是 比较 常用 的 一 个 。 


我 们 在 Gemfile 中 安装 haml : 


gem 'haml' 


我 们 看 一 下 用 haml 写 的 代码 : 


%section.container 
%h1= post.title 
%h2= post.subtitle 
content 

= post.content 


下 面 是 erb 的 写法 。 


«section class-"container"» 
<h1><%= post.title %></h1> 
<h2><%= post.subtitle %></h2> 
«div class-”content”5 

<%= post.content %> 
«/div» 


«/section» 


可 见 haml 节省 了 我 们 大 量 的 代码 ， 而 且 更 接近 Ruby 语法 。 我 们 看 几 个 haml 常用 的 写法 : 


.title- "I am Title" 
#title= "I am Title" 


«div class="title">I am Title</div> 
«div id="title">I am Title</div> 


下 面 是 显示 ul 列表 ， 注 意 ，haml 的 缩 进 是 2 个 空格 : 


%ul 
9i Salt 
411 Pepper 


这 是 循环 的 例子 : 


- (42...47).each do |i| 
%p= i 
%p See, I can count! 


我 们 如 果 想 在 项 目 里 使 用 ham 文件 ， 只 需要 创建 一 个 xxx.html.ham] 文件 即 可 ， 这 是 一 个 
完整 的 haml 例子 : 


[LI 
96htmlfhtm1 attrs) 
%head 
%title Hampton Catlin Is Totally Awesome 
ymeta{"http-equiv" => "Content-Type", :content => "text/html; charset=utf-8"} 
96body 
96h1 
This is very much like the standard template, 
except that it has some ActionView-specific stuff. 
It's only used for benchmarking. 
.crazy partials- render :partial -5 'templates/av partial 1' 
/ You're In my house now! 
.header 
Yes, ladies and gentileman. He is just that egotistical. 
Fantastic! This should be multi-line output 
The question is if this would translate! Ahah! 
= 1+ 9+ 8 + 2 #numbers should work and this should be ignored 
#body= " Quotes should be loved! Just like people!" 
- 120.times do |number | 


- number 
Wow. | 
96p 
- "Holy cow weap | 
"multiline wap | 
"tags! wap | 


"A pipe (|) even!" | 
= [1, 2, 3].collect { |n| "PipesIgnored|" } 
[1, 2, 3].collect { |n| | 
n.to_s | 
}.join("|") | 
96div.silent 


- foo = String.new 

- foo «« "this" 

- foo «« " shouldn't" 

- foo «« " evaluate" 

= foo + " but now it should!" 
-# Woah crap a comment! 


-# That was a line that shouldn't close everything. 
%ul.really.cool 


- ('a'..'f').each do |a] 
%li= a 
#combo.of_divs_with_underscore= @should_eval = "with this text" 
= [ 104, 101, 108, 108, 111 ].map do |byte| 
- byte.chr 
. Footer 


%strong.shout= "This is a really long ruby quote. It should be loved and wrapped 
because its more than 50 characters. This value may change in the future and this tes 
t may look stupid. \nSo, I'm just making it *really* long. God, I hope this works" 


这 个 文件 来 自 这 里 ， 你 可 以 在 这 里 找到 它 的 源码 。 


在 这 里 还 有 一 份 文 档 。 
如 果 打 算 把 现 有 的 erb 转 成 haml， 可 以 使 用 haml 提供 的 一 个 命令 行 工 具 html2haml， 我 们 
在 Gemfile 里 安装 台 : 


gem 'html2haml' 
在 命令 行 里 ， 直 接 使 用 它 : 
96 htm12haml -e index.erb index.haml 


-e 参数 ， 可 以 把 erb 模板 转 成 haml e 


这 里 有 一 个 网 站 ， 是 在 线 把 html/erb 转 成 haml。 如 果 需 要 把 haml 转 回 erb 模板 ， 可 是 试 试 
这 个 网 站 。 


为 了 方便 的 使 用 haml， 尤 其 在 使 用 scaffold 或 者 generate 创建 文件 的 时 候 ， 自 动 创建 


haml， 而 不 是 erb， 可 以 安装 haml-rails : 
gem "haml-rails" 
它 为 我 们 提供 了 一 个 快速 转换 的 工具 : 


rake haml:erb2haml 
它 可 以 把 所 有 views 文件 夹 下 的 erb 模板 ， 转 成 haml 。 


3.4.2 slim 


和 haml 类 似 ，slim 更 加 的 简洁 ， 从 它 的 官网 首页 可 以 看 到 它 的 代码 风格 ， 而 且 比 ham 又 少 


了 一 些 分 隔 符 。 


doctype html 
html 
head 
title Slim Examples 
meta name- "keywords" content="template language" 
meta name-"author" content-author 
javascript: 
alert('Slim supports embedded javascript!') 


body 
hi Markup examples 


content 
p This example shows you how a basic Slim file looks like. 


== yield 


- unless items.empty? 
table 
- for item in items do 
tr 
td.name = item.name 
td.price - item.price 
- else 


p 
| No items found. Please add some inventory. 


Thank you! 
div id- "footer" 


- render 'footer' 
| Copyright © #{year} (author) 


这 是 官网 首页 给 出 的 代码 示例 ， 这 里 有 它 详尽 的 使 用 手册 。 


slim 为 我 们 提供 了 两 个 工具 : html2slim 可 以 把 html/erb 转换 成 slim > haml2slim 把 haml 转 
成 slim ° 


和 haml-rails 一 样 ，slim-rails 可 以 默认 生成 slim 模板 。 

在 这 里 ， 有 一 个 在线 工具 ， 把 html 转换 成 slim o 

3.4.3 liquid 

上 面 两 个 模板 引擎 (template engine) 是 针对 开发 者 的 ， 因 为 我 们 编写 的 代码 是 不 会 交付 给 
使 用 者 的 ， 但 是 ， 如 果 我 们 需要 把 页 面 开 放 给 使 用 者 随意 编辑 ， 以 上 提 到 的 erb > haml » slim 


是 绝对 不 可 以 的 ， 因 为 使 用 者 可 以 在 页 面 里 这 么 写 : 


<%= User.destroy all %> 


那么 ， 如 何 给 使 用 者 一 个 安全 的 模板 来 自由 编辑 呢 ? liquid 是 一 个 很 好 的 方案 。liquid 是 著名 
的 电 商 网 站 Shopify 设计 并 开源 的 安全 模板 引擎 。 


liquid 不 允许 执行 危险 的 代码 ， 所 以 可 以 随意 交 给 使 用 者 编辑 并 且 直 接 泻 染 成 页 面 ， 它 还 可 以 
保存 到 数据 里 ， 这 样 可 以 实现 在 线 编辑 模板 ， 它 将 逻辑 代码 和 表现 代码 分 开 ， 如 果 你 熟悉 
php 的 smarty 模板 ， 那 么 你 会 发 现 liquid 就 是 Ruby 版 的 smarty。 


我 们 看 一 个 例子 : 


«ul id-"products"» 
[96 for product in products %} 
<li> 
<h2>{{ product.name }}</h2> 
Only {{ product.price | price }} 
{{ product.description | prettyprint | paragraph }} 
</li> 
{% endfor %} 
</ul> 


这 是 我 们 的 liquid 模板 ， 我 们 把 Product 的 Model 也 改写 一 下 ， 让 liquid 可 以 读 取 它 的 属 
p: 


class Product « ActiveRecord::Base 
def to liquid 


{ 
"name" => name, [1] 这 里 要 用 string 的 写法 ， 不 要 使 用 symbol» 
"price" -» price 
} 
end 


我 们 来 泻 染 (Render) 这 个 模板 : 


require "liquid" 

template = Liquid::Template.parse(template) # template 就 是 上 面 的 代码 ， 可 以 直接 从 数据 库 读 取 
出 来 。 

template.render('products' => Product.all) # 传 入 products 变量 ， 这 是 由 我 们 控制 传 入 的 ， 用 户 
可 以 在 模板 中 随意 调用 。 


liquid 的 源码 在 https://github.com/Shopify/liquid > 7 
https://github.com/Shopify/liquid/wiki/Liquid-for-Designers， 有 非常 详尽 的 使 用 方法 。 


和 haml-rails > slim-rails 一 样 ，liquid 也 有 自己 的 : 


gem 'liquid-rails' 


它 可 以 方便 的 使 用 Rails 中 的 Helper 和 Tag * ZA Drop Class， 并 且 编 写 Rspec 测试 。 
Rails 使 用 Tilt 这 个 Gem 来 处 理 各 种 模板 引擎 ，Tilt 是 一 个 接口 ， 支 持 几 十 个 模板 引擎 ， 我 们 
只 是 提 到 了 其 中 较 常 用 的 三 个 。 

使 用 tilt 方便 我 们 在 Rails 集成 各 种 模板 引擎 ， 不 过 实际 开发 的 时 候 ， 我 们 要 注意 他 们 的 效率 
问题 。 这 里 有 一 份 测试 数据 : 


# Linux + Ruby 1.9.2, 1000 iterations 


(1) 
(1) 
(1) 
(1) 
(1) 
(1) 


(2) 
(2) 
(2) 
(2) 
(2) 
(2) 


(3) 
(3) 
(3) 
(3) 
(3) 
(3) 


(4) 
(4) 
(4) 
(4) 
(4) 


st 


user system total real 
erb 0.680000 0.000000 0.680000 ( 0.810375) 
erubis 0.510000 0.000000 0.510000 ( 0.547548) 
fast erubis 0.530000 0.000000 0.530000 ( 0.583134) 
slim 4.330000 0.020000 4.350000 ( 4.495633) 
haml 4.680000 0.020000 4.700000 ( 4.747019) 
haml ugly 4.530000 0.020000 4.550000 ( 4.592425) 
erb 0.240000 0.000000 0.240000 ( 0.235896) 
erubis 0.180000 0.000000 0.180000 ( 0.185349) 
fast erubis 0.150000 0.000000 0.150000 ( 20.154970) 
slim 0.050000 0.000000 0.050000 ( 0.046685) 
haml 0.490000 0.000000 0.490000 ( 0.497864) 
haml ugly 0.420000 0.000000 0.420000 ( 0.428596) 
erb 0.030000 0.000000 0.030000 ( 0.033979) 
erubis 0.030000 0.000000 0.030000 ( 0.030705) 
fast erubis 0.040000 0.000000 0.040000 ( 0.035229) 
slim 0.040000 0.000000 0.040000 ( 20.036249) 
haml 0.160000 0.000000 0.160000 ( 0.165024) 
haml ugly 0.150000 0.000000 0.150000 ( 0.146130) 
erb 0.060000 0.000000 0.060000 ( 0.059847) 
erubis 0.040000 0.000000 0.040000 ( 0.040770) 
slim 0.040000 0.000000 0.040000 ( 0.047389) 
haml 0.190000 0.000000 0.190000 ( 0.188837) 
haml ugly 0.170000 0.000000 0.170000 ( 0.175378) 


Uncached benchmark. Template is parsed every time. 
Activate this benchmark with slow=1. 


Cached benchmark. Template is parsed before the benchmark. 
The ruby code generated by the template engine might be evaluated every time. 
This benchmark uses the standard API of the template engine. 


Compiled benchmark. Template is parsed before the benchmark and 
generated ruby code is compiled into a method. 

This is the fastest evaluation strategy because it benchmarks 
pure execution speed of the generated ruby code. 


Compiled Tilt benchmark. Template is compiled with Tilt, which gives a more 
accurate result of the performance in production mode in frameworks like 
Sinatra, Ramaze and Camping. (Rails still uses its own template 
compilation. ) 


该 数据 来 自 : https://ruby-china.org/topics/634 


选择 哪个 模板 引擎 ， 还 是 直接 使 用 erb， 需 要 视 情 况 而 定 了 。 


3.4.4 devise 的 邮件 模板 


Devise 除了 提供 用 户 注 册 和 登录 功能 ， 还 可 以 通过 邮件 激活 用 户 。 这 里 ， 我 们 可 以 自己 定义 
邮件 模板 中 的 内 容 。 


我 们 修改 一 下 User 中 关于 Devise 的 配置 : 


devise :database authenticatable, :registerable, 
:recoverable, :rememberable, :trackable, :validatable, 
:confirmable 


我 们 增加 了 一 个 新 的 选项 : :confirmable e 


我 们 配置 下 邮件 发 送 的 信息 ， 这 里 我 们 只 在 开发 环境 (development) 配置 ， 我 们 打开 
config/environments/development.rb 
config.action mailer.default url options - 


{ host: 'localhost', port: 3000 } 


config.action mailer.delivery method = 
config.action mailer.smtp settings = ( 


:smtp 


address: 'smtp.163.com', 
port: 25, 

domain: Leek Uu 

user name: !'...0163.com', 
password: SO 
authentication: : plain, 

enable starttls auto: true 


同时 ， 我 们 还 需要 修改 user 创建 时 的 migration 文件 ， 打 开 


db/migrate/xxxx devise create users.rb ， 我 们 取消 注释 这 个 部 分 : 





## Confirmable 

t.string :confirmation token 
t.datetime :confirmed at 
t.datetime :confirmation sent at 


t.string :unconfirmed email £ Only if using reconfirmable 


注意 ，XXXX EB MAM, KANI AE B JI o devise 已 经 为 我 们 添加 了 
confirmable 需要 的 字段 ， 我 们 不 必 自 己 添加 。 这 里 有 一 个 问题 ， 我 们 已 经 运行 过 数据 库 文 
件 了 ， 这 里 是 修改 昌文 件 ， 我们 不 能 直接 更 新 文件 ， 这 里 我 们 可 以 删 掉 旧 的 数据 库 ， 其 实在 
开发 环境 ， 我 们 可 以 经 常 重建 数据 库 : 


rake db:drop 
rake db:create 
rake db:migrate 
rake db:seed 


还 记得 db/seeds.rb 这 个 文件 吧 ， 我 们 可 以 把 一 些 默认 数据 写 到 seed 里 ， 或 者 一 些 测 试 数 
据 ， 比 如 我 们 添加 50 个 商品 信息 ， 来 测试 分 页 等 效果 是 否 正确 ， 或 者 初始 化 几 十 个 商品 类 别 
等 。 这 样 ， 重 建 数 据 库 时 ， 不 必 担 心 默认 数据 的 丢失 。 


我 们 再 编辑 下 devise 的 配置 文件 ， 它 在 config/initializers/devise.rb 


config.mailer sender = '...@163.com' 


config.mailer - 'Devise::Mailer' 


我 们 重新 启动 Rails 服务 ， 注 册 一 个 账号 ， 这 时 我 们 观察 终端 ， 可 以 看 到 邮件 发 送 的 信息 : 


Sent mail to hi@liwei.me (2468.6ms) 

Date: Mon, 02 Mar 2015 14:04:57 +0800 

From: masterQ... 

Reply-To: masterQ... 

To: hiQliwei.me 

Message-ID: <54f3fd89f0f84_62213ffdf44a34e08208d@macbook.local.mail> 
Subject: -?UTF-8?Q?-E6-9D-A5-E8-87-AAezcms-E7-9A-84-E6-B3-A8-E5-86-8C-E7-A1-AE-E8-AE-A 
4=E9=8 2=AE=E4=BB=B6?= 

Mime-Version: 1.0 

Content-Type: text/html; 

charset=UTF-8 

Content-Transfer-Encoding: 7bit 


<p>Welcome hi@liwei.me!</p> 
<p>You can confirm your account email through the link below:</p> 


<p><a href="http://localhost :3000/users/confirmation?confirmation_token=FNMGvy_VnNfyh 
HKz_LKY">Confirm my account</a></p> 


我 们 页 面 上 ， 也 会 得 到 这 样 的 提示 : 


D localhost:3000 





《Rails 实 践 》 MENT 。 我 的 订单 全 部 分 类 ~ EJ 


一 封 带 有 确认 链接 的 邮件 已 经 发 送 至 您 的 邮箱 ， 请 检查 邮箱 〈 包 括 垃圾 邮箱 ) ， 并 点 击 该 链接 激活 您 的 账号 。 


商品 


rss atom 


名 称 描述 价格 ”添加 日 期 管理 


©2015 «Rails 实践 》 网 店 演示 


为 了 让 我 们 的 邮件 看 起 来 更 友好 ， 我 们 编辑 
app/views/users/mailer/confirmation instructions.html.erb 
<p> 你 好 <%= Qemail %>!</p> 
<p> 请 点 击 下 面 的 确认 链接 ， 验 证 您 的 邮箱 :</p> 
<p><%= link to "验证 我 的 邮箱 "，confirmation_url(@resource, confirmation token: @token) 


%></p> 


你 可 以 再 试 试看 。 不 过 这 种 配置 可 能 会 被 当做 垃圾 邮件 拒 收 ， 或 者 直接 被 放 到 垃圾 邮件 中 。 
在 后 面 的 章节 里 ， 我 们 会 介绍 其 他 的 方式 发 送 邮 件 。 

如 果 你 不 能 通过 邮件 激活 这 个 用 户 ， 比 如 那些 在 seed 中 添加 的 用 户 ， 没 关系 ， rails c X 
入 控制 台 : 


u = User.last [1] 
u.confirm! [2] 


e [1] 找到 这 个 用 户 ， 更 多 方法 在 下 一 章 陆 续 介绍 
e [2] confirm 方法 激活 用 户 


更 多 邮件 配置 ， 可 以 查看 http://guides.rubyonrails.org/configuring.html#configuring-action- 


mailer 


第 四 章 Rails 中 的 模型 


课程 概要 : 


本 课程 讲解 Rails 模型 (Model) 中 基本 的 CRUD 操作 、 模 型 间 的 关联 关系 、 属 性 校 验 、 回 调 
以 及 编写 Rspec 测试 的 方法 ， 并 完成 网 店 的 数据 库 模 型 设计 。 


a qu AAAN 


CRUD 

， 数 据 库 迁移 (Migration) 
. 表 间 关联 (Relations) 

. 属性 校 验 (Validates) 

. 1114 (Callback) 


oa A U N = 


课程 背景 


模型 (Model) 是 MVC 架构 中 的 M， 代 表 数 据 库 ， 通 过 对 模型 的 学 习 ， 可 以 了 解 Rails 是 如 
何 实现 数据 库 操 作 的 。 


4.1 模型 的 基础 操作 


概要 : 

本 课时 讲解 模型 的 基础 操作 ， 数 据 迁 移 ， 常 用 的 CRUD 方法 ， 在 数据 查询 时 ， 如 何 避 免 N+1 
问题 ， 如 何 使 用 Scope 包装 查询 条 件 ， 编 写 模型 Rspec 测试 。 

知 TR AAAN 


1. Active Record 
2. Migration 
3. CRUD 


alow a 


4.1.1 Active Record 简介 


Active Record 模式 ， 是 由 Martin Fowler 的 《企业 应 用 架构 模式 》 一 书 中 提出 的 ， 在 该 模式 
中 ， 一 个 Active Record (简称 AR) 对 象 包含 了 持久 数据 (保存 在 数据 库 中 的 数据 ) 和 数据 
操作 (对 数据 库 里 的 数据 进行 操作 ) 。 


xt RK ARMA (Object-Relational Mapping， 简 称 ORM) ， 是 将 程序 中 的 对 象 (Object) 和 
关系 型 数据 库 (Relational Database) de 行 关联 。 使 用 ORM 可 以 方便 的 将 对 象 的 ow, 
性 和 关联 关系 保存 入 数据 库 ， 这 样 可 以 不 必 编 写 复 杂 的 SQL 语句 ， 而 且 不 必 担 心 使 用 的 是 
哪 种 数据 库 ， 一 次 编写 的 代码 可 以 应 用 在 Sqlite，Mysql，PostgreSQL 等 各 种 数据 库 上 。 


Active Record 就 是 个 ORM 框架 。 
所 以 ， 我 们 可 以 用 Actice Record 来 做 这 几 件 事 : 


e 表示 模型 (Model) 和 模型 数据 

e 表示 模型 间 的 关系 (比如 一 对 多 ， 多 对 多 关系 ) 
e 通过 模型 间 关 联 表 示 继 承 层 次 

e 在 保存 如 数据 库 前 ， 校 验 模型 (比如 属性 校 验 ) 
e 用 面向 对 象 的 方式 处 理 数 据 库 


4.1.2 Active Record 中 的 约定 


Rails 中 使 用 了 ActiveRecord 这 个 Gem ， 使 用 它 可 以 不 必 去 做 任何 配置 (大 多 数 情况 是 这 样 


a) ， 还 记得 Rails 的 两 个 哲学 理念 之 一 么 : 约定 优 于 配置 。 ( 另 一 个 是 不 要 重复 自己 ， 这 是 
Dave Thomas 在 《程序 员 修 炼 之 道 》 一 书 里 提出 的 。) 





么 ， 我 们 讲 两 个 Active Record 中 的 约定 : 


4.1.2.1 命名 约定 


e 数据 表 名 : 复数 ， 下 划 线 分 隔 单词 (例如 book clubs) 
e 模型 类 名 : 单数 ， 每 个 单词 的 首 字母 大 写 (例如 BookClub) 


比如 : 


模型 (Class) 数据 表 (Schema) 


Post posts 
Lineltem line_items 
Deer deers 
Mouse mice 
Person people 


单词 在 单 复数 转换 时 ， 是 按照 英文 语法 约定 的 。 


4.1.2.2 Schema 约定 


注 : 数据 库 中 的 Schema， 指 数据 库 对 象 集合 ， 可 以 被 用 户 直接 使 用 。Schema & & žE 
辑 结构 ， 用 户 可 以 通过 命名 调用 数据 库 对 象 ， 并 且 安 全 的 管理 数据 库 。 


e 外 键 - 使 用 singularized table name id 形式 命名 ， 例 如 item_id，order id。 创建 模型 
关联 后 ，Active Record 会 查找 这 个 字段 ; 

e 主键 -默认 情况 下 ，Active Record 使 用 整数 字段 id 作为 表 的 主键 。 使 用 Active Record 
迁移 创建 数据 表 时 ， 会 自动 创建 这 个 字段 ; 


在 数据 库 字 段 命名 的 时 候 ， 有 几 个 特殊 意义 的 名 字 ， 尽 量 回避 : 


e created_at- 创建 记录 时 ， 自 动 设 为 当前 的 时 间 截 

e updated at- 更 新 记录 时 ， 自 动 设 为 当前 的 时 间 疏 

e lock version - 在 模型 中 添加 乐观 锁定 功能 

e type - 让 模型 使 用 单 表 继承 ， 给 字段 命名 的 时 候 ， 尽 量 避 开 这 个 词 

e (association name) type - 多 态 关联 的 类 型 

e (table name) count - 保存 关联 对 象 的 数量 。 例 如 ，posts 表 中 的 comments count € 
段 ，Rails 会 自动 更 新 该 文章 的 评论 数 


4.1.3 数据 库 迁 移 〈Migration ) 


在 我 们 使 用 scaffold 创建 资源 的 时 候 ， 或 者 使 用 generate 创建 model 的 时 候 ，Rails 会 给 我 
们 自动 创建 一 个 数据 库 迁 移 文 件 ， 它 在 db/migrate Po CA AACE AR > 他们 按照 时 间 
的 先后 顺序 排列 ， 当 运行 数据 库 迁 移 时 ， 他 们 按照 时 间 顺 序 先后 被 执行 。 


新 创建 的 迁移 文件 ， 我 们 使 用 rake db:migrate 命令 执行 它 (11) ， 这 里 会 判断 ， 哪 个 迁移 
文件 是 还 没有 被 执行 的 。 


如 果 我 们 对 执行 过 的 迁移 操作 不 满意 ， 我 们 可 以 回 滚 这 个 进 移 : 


rake db:rollback [1] 
rake db:rollback STEP-3 [2] 


[1] ER X 近 的 一 个 迁移 
[2] 回 滚 指定 的 迁移 个 数 


回 滚 之 后 ， 迁 移 停留 在 回 滚 到 的 那个 位 置 的 ，schema 也 会 更 新 到 那个 位 置 时 的 状态 。 比 如 ， 
我 们 上 一 次 迁移 执行 了 5 个 文件 ， 我 们 回 滚 的 时 候 ， 是 一 个 个 文件 回 滚 的 ， 所 以 我 们 指定 
STEP=5， 才 能 把 刚才 迁移 的 5 个 文件 回 滚 。 


在 我 们 开发 代码 的 过 程 中 ， 有 是 会 iin a 个 字段 ， 我 们 回 滚 之 后 ， 在 迁移 文件 中 
把 它 加 上 ， 然 后 ， 我 们 rake db:migrate 再 次 运 。 不 过 ， rake db:migrate:redo [STEP=3] 
直接 回 滚 然 后 再 次 运行 迁移 ， 这 样 会 方便 些 。 


这 种 回 滚 操作 适合 开发 过 程 中 ， 出 现 了 新 的 想法 ， 而 回 滚 最 近 连 续 的 几 个 迁移 。 


如 果 我 们 想 回 滚 很 久 以 前 的 某 个 操作 ， 而 且 在 那个 迁移 之 后 ， 我 们 已 经 执行 了 多 个 迁移 。 这 
时 该 如 何 处 理 呢 ? 


如 果 在 开发 阶段 Aa rake db:drop ， rake db:create ， rake db:migrate 。 但 是 在 生 
产 环境 ， 我 们 决 不 能 这 么 做 ， 这 时 我 们 要 针对 需求 ， 编 写 一 个 迁移 文件 : 


class ChangeProductsPrice < ActiveRecord::Migration 
def change 
reversible do |dir| 
change table :products do |t| 
dir.up { t.change :price, :string } 
dir.down { t.change :price, :integer } 
end 
end 
end 
end 


或 者 : 


class ChangeProductsPrice « ActiveRecord::Migration 
def up 
change table :products do |t| 
t.change :price, :string 
end 
end 


def down 
change table :products do |t| 
t.change :price, :integer 
end 
end 
end 


up 是 向 前 迁移 到 最 新 的 ，down ATER ° 


我 们 创建 一 个 model 的 时 候 ， 会 自动 创建 它 的 migration 文件 ， 我 们 还 可 以 使 用 rails g 
migration Xxx 的 方法 ， 添 加 自 定义 的 迁移 文件 。 如 果 我 们 的 命名 是 "AddXXXToYYY" 或 者 
"RemoveXXXFromYYY" 时 ， 会 自动 为 我 们 添加 字符 类 型 的 字段 ， 比 如 我 为 variant 添加 一 个 
color 字段 : 


rails g migration AddColorToVariants color:string 


它 的 内 容 是 : 


class AddColorToVariants < ActiveRecord::Migration 
def change 
add column :variants, :color, :string 
end 
end 


4.1.4 CRUD 


CRUD 并 不 是 一 个 Rails 的 概念 ， 它 表示 系统 (AFA) 和 数据 库 (持久 层 ) 之 间 的 基本 操 
作 ， 简 单 的 讲 叫 " 增 (C) 删 (D) 改 (U) 查 (R)”。 


我 们 已 经 使 用 scaffold 命令 创建 了 资源 : 商品 (product) ， 我 们 现在 使 用 
app/models/product.rb 来 演示 这 些 操作 2 


首先 ， 我 们 需要 让 Product 类 继承 ActiveRecord : 


class Product < ActiveRecord::Base 
end 


124 > Product 类 就 可 以 操作 数据 库 了 ， 是 不 是 很 简单 。 


4.1.5 创建 记录 
我 们 使 用 Product 类 ， 向 数据 添加 一 条 记录 ， 我 们 先进 入 Rails 控制 台 : 


% rails c 
Loading development environment (Rails 4.2.0) 
> Product.create [1] 
(0.2ms) begin transaction [2] 
SQL (2.8ms) INSERT INTO "products" ("created at", "updated at") VALUES (?, ?) [["c 
reated at", "2015-03-14 16:23:44.640578"], ["updated at", "2015-03-14 16:23:44.640578" 
]] 


(0.8ms) commit transaction [2] 
=> #<Product id: 1, name: nil, description: nil, price: nil, created at: "2015-03-14 
16:23:44", updated at: "2015-03-14 16:23:44"» [3] 


这 里 ， 我 贴 出 了 完整 的 代码 。 


[1]， 我 们 使 用 了 Product 的 类 方法 create， 创 建 了 一 条 记录 。 我 们 还 有 其 他 的 方法 保存 记 


[2]，begin 和 commit ， 将 我 们 的 数据 保存 入 数据 库 。 如 果 在 保存 的 时 候 出 现 错误 ， 比 如 属性 
校 验 失 败 ， 抛 出 异常 等 ， 不 会 将 记录 保存 到 数据 库 。 


[3]， 我 们 拿 到 了 一 个 Product 类 的 实例 。 


除了 类 方法 ， 我 们 还 可 以 使 用 实例 的 save 方法， 来 保存 记录 到 数据 ， 比 如 : 


> product = Product.new [1] 
=> #<Product id: nil, name: nil, description: nil, price: nil, created at: nil, updat 
ed at: nil» [2] 
» product.save [3] 
(0.1ms) begin transaction [4] 

SQL (0.9ms) INSERT INTO "products" ("created at", "updated at") VALUES (?, ?) [["c 
reated at", "2015-03-14 16:47:26.817663"], ["updated at", "2015-03-14 16:47:26.817663" 
]] 

(9.3ms) commit transaction [4] 
-» true [5] 


[1]， 我 们 使 用 类 方法 new， 来 创建 一 个 实例 ， 注 意 ，[2] 告诉 我 们 ， 这 是 一 个 没有 保存 到 数据 
库 的 实例 ， 因 为 它 的 id FA nil o 


[3] 我 们 使 用 实例 方法 save， 把 这 个 实例 ， 保 存 到 数据 库 。 


[4] 调用 save 后 ， 会 返回 执行 结果 ，true 或 者 false。 这 种 判断 很 有 用 ， 而 且 也 很 常见 ， 如果 
你 现在 打开 app/controllers/products_controller.rb 的 话 ， 可 以 看 到 这 样 的 判断 : 


if @product. save 
else 


end 


那么 ， 你 可 能 会 有 个 疑问 ， 使 用 类 方法 create 保存 的 时 候 ， 如 果 失 败 ， 会 返回 我 们 什么 呢 ? 
是 一 个 实例 ， 还 是 false ? 


我 们 使 用 下 一 章 里 要 介绍 的 属性 校 验 ， 来 让 保存 失败 ， 上 比如， 我 们 让 商品 的 名 称 必 须 填 写 : 


class Product < ActiveRecord::Base 
validates :name, presence: true [1] 
end 


[1] validates 是 校 验 命 令 ， 要 求 name 属性 必须 填写 。 


好 了 ， 我 们 来 测试 下 类 方法 create 会 返回 给 我 们 什么 


> product = Product.create 
(0.3ms) begin transaction 
(0.1ms) rollback transaction 
=> #<Product id: nil, name: nil, description: nil, price: nil, created at: nil, updat 
ed at: nil» 
2.2.0 :003 » 


答案 揭晓 ， 它 返回 给 我 们 一 个 未 保存 的 实例 ， 它 有 一 个 实用 的 方法 ， 可 以 查看 哪里 出 了 错 


> proud gals: full_messages 
=> [" 名 称 不 能 为 空 字符 "] 


当然 ， 判 断 一 个 实例 是 否 保存 成 功 ， 不 必 去 检查 它 的 errors 是 否 为 室 ， 有 两 个 方法 会 根据 
errors 是 否 添加 ， 而 返回 实例 的 状态 : 


person = Person.new 
person.invalid? 
person.valid? 


X U BH > invalid? 和 valid? 都 会 调用 实例 的 校 验 。 


我 使 用 类 方法 和 实例 方法 的 称呼 ， 希 望 没有 给 你 造成 理解 的 障碍 ， 如 果 有 些 难 理解 ， 建 议 你 
先 看 一 看 Ruby 中 关于 类 和 实例 的 介绍 。 


4.1.6 查询 记录 


4.1.6.1 Find 查询 


数据 查询 ， 是 Rails 项 目 经 常 要 做 的 操作 ， 如 何 拿 到 准确 的 数据 ， 优 化 查询 ， 是 我 们 要 重点 关 


注 的 。 


查询 时 ， 会 得 到 两 种 结果 ， 一 个 实例 ， 或 者 实例 的 集合 (Array) 。 如 果 找 不 到 结果 ， 也 会 给 
有 两 种 情况 ， 返 回 nil 或 空 数组 ， 或 者 抛 出 ActiveRecord::RecordNotFound 异常 。 


Rails 给 我 们 提供 了 这 些 常用 的 查询 方法 : 


方法 名 Bal 
f 含义 

find 获取 指定 主键 对 应 的 对 象 
jk 一 个 记录 ， 不 RS aT Jj 

take 获取 一 个 记录 ， 不 考虑 任何 顺 
Æ 

fi 获取 按 主键 排序 得 到 的 第 一 个 

irst OA 
记录 

last 获取 按 主键 排序 得 到 的 最 后 一 
个 记录 


find by ”获取 满足 条 件 的 第 一 个 记录 


无 


hash 


例子 


Product.find(10) 


Product.take 


Product.first 


Product.last 


Product.find by(name: 
"Th ng 


表 中 的 四 个 方法 不 会 抛 出 异常 ， 如 果 需 要 抛 出 异常 ， 可 以 在 他 们 名 字 后 面 加 上 ! > 


Product.take! ° 


如 果 将 上 面 几 个 方法 的 参数 改动 ， 我 们 就 会 得 到 集合 : 


find 获取 指定 主键 对 应 的 对 象 
take | 获取 一 个 记录 ， 不 考虑 任何 顺 


H 


first 获取 按 主 键 排 序 得 到 的 第 N 个 记 
获取 按 主 键 排序 得 到 的 最 后 N 个 
last ONDE 
了 记录 
all 获取 按 主 键 排序 得 到 的 全 部 记 


录 


参数 例子 
DET Product.find([1,2,3]) 
个 数 Product.take(2) 
个 数 Product.first(3) 
个 数 Product.last(4) 
无 Product.all 


nil 


nil 


nil 


比如 


Rails 还 提供 了 一 个 find_by 的 查询 方法 ， 它 可 以 接收 多 个 查询 参数 ， 返 回 符合 条 件 的 第 一 个 
记录 。 比 如 : 


Product.find by(name: 'T-Shirt', price: 59.99) 


find by 有 一 个 常用 的 变形 ， 比 如 : 


Product.find by name("Hat") 
Product.find by name and price("Hat", 9.99) 


T 


果 需 要 查询 不 到 结果 抛 出 异常 ， 可 以 使 用 find byr 。 通 常 ， 以 ! 结尾 的 方法 都 会 抛 出 异 
常 ， 这 也 是 一 种 约定 。 不 过 ， 直 接 使 用 find， 会 查询 主 索引 ， 查 询 不 到 直接 抛 出 异常 ， 所 以 是 
没有 find! 方法 的 。 


使 用 find_by 的 时 候 ， 还 可 以 使 用 sql 语句 ， 比 如 : 


Product.find by("name = ?", "T") 
这 是 一 个 有 用 的 查询 ， 当 我 们 搜索 多 个 条 件 ， 并 且 是 OR 关系 时 ， 可 以 这 样 做 : 
User.find by("id = ? OR login = ?", params[:id], params[:id]) 
这 名 话 还 可 以 改写 成 : 
User.find by("id = :id OR login = :name", id: params[:id], name: params[:id]) 
或 者 更 简洁 的 : 


User.find by("id = :q OR login = :q", q: params[:id]) 


4.1.6.2 Where 查询 


集合 的 查找 ， 最 常用 的 方法 是 where ， 它 可 以 通过 多 种 形式 查找 记录 : 


查询 形式 实例 
数组 (Array) 查询 Product.where("name = ? and price = ?", "Th", 9.99) 
ir (hash) 查询 Product.where(name: "Th", price: 9.99) 
Not 4 74 Product.where.not(price: 9.99) 


gc 


7E Product.none 


使 用 where 查询 ， 常 见 的 还 有 模糊 查询 : 
Product.where("name like ?", "%a%") 
查询 某 个 区 间 : 
Product.where(price: 5..6) 
以 及 上 面 提 到 的 ，sql 的 查询 : 


Product.where("color - ? OR price > ?", "red", 9) 


Active Record 有 多 种 查询 方法 ， 以 至 于 Rails 手册 中 单独 列 出 一 章 来 讲解 ， 而 且 讲解 的 很 细 
致 ， 如 果 你 想 灵 活 的 掌握 这 些 数据 查询 方法 ， 建 议 你 经 常 阅 读 Active Record Query Interface 
一 章 ， 这 是 中 文 版 。 


4.1.7 更 新 记录 (Update ) 
和 创建 记录 一 样 ， 更 新 记录 也 可 以 使 用 类 方法 和 实力 方法 。 
类 方法 是 update， 比 如 : 


Product.update(1, name: "T-Shirt", price: 23) 


1 是 更 新 目标 的 ID ， 如 果 该 记录 不 存在 ? update 会 抛 出 ActiveRecord::RecordNotFound Jf 


常 。 
update 也 可 以 更 新 多 条 记录 ， 比 如 : 


Product.update([1, 2], [( name: "Glove", price: 19 }, { name: "Scarf" }]) 


我 们 看 看 它 的 源 代码 : 


# File activerecord/lib/active record/relation.rb, line 363 
def update(id, attributes) 
if id.is a?(Array) 
id.map.with index ( |one id, idx| update(one id, attributes[idx]) } 
else 
object - find(id) 
object.update(attributes) 
object 
end 
end 


如 果 要 更 新 全 部 记录 ， 可 以 使 用 update all : 


Product.update all(price: 20) 


在 使 用 update 更 新 记录 的 时 候 ， 会 调用 Model 的 validates (432) 和 callbacks (回调 ) > 
保证 我 们 写 入 正确 的 数据 ， 这 个 是 定义 在 Model 中 的 方法 。 但 是 ，update all 会 略 过 校 验 和 
回调 ， 直 接 将 数据 写 入 到 数据 库 中 。 


fe update all 类似，update_column/update_columns 也 是 将 数据 直接 写 入 到 数据 库 ， 它 是 一 
个 实例 方法 : 


product = Product.first 
product.update column(:name, "") 
product.update columns(name: "", price: 0) 


虽然 为 product 增加 了 name 非 空 的 校 验 ， 但 是 update column(s) 还 是 可 以 讲 数 据 写 入 数据 
库 。 


当 我 们 创建 迁移 文件 的 时 候 ，Rails 默认 会 添加 两 个 时 间 改 字段 ，created at 和 updated at ° 


当 我 们 使 用 update 更 新 记录 时 ， 触 发 Model 的 校 验 和 回调 时 ， 也 会 自动 更 新 updated at 字 
段 。 但 是 Model.update_all 和 model.update column(s) 在 跳 过 回调 和 校 验 的 同时 ， 也 不 会 更 
新 updated at 字段 。 


我 们 也 可 以 用 save 方法， 将 新 的 属性 保存 到 数据 库 ， 这 也 会 触发 调用 和 回调 ， 以 及 更 新 时 间 


product = Product.first 
product.name - "Shoes" 
product.save 


4.1.8 删除 记录 (Destroy) 


在 我 们 接触 计算 机 英语 里 ， 表 示 删 除 的 英文 有 很 多 ， 这 里 我 们 用 到 的 是 destroy, delete ^ 


4.1.8.1 Delete 删除 


使 用 delete 删除 时 ， 会 跳 过 回调 ， 以 及 关联 关系 中 定义 的 :dependent 选项， 直接 从 数据 库 
中 删除 ， 它 是 一 个 类 方法 ， 比 如 : 


Product.delete(1) 
Product.delete([2,3,4]) 


当 传 入 的 id 不 存在 的 时 候 ， 它 不 会 抛 出 任何 异常 ， 看 下 它 的 源码 : 


# File activerecord/lib/active record/relation.rb, line 502 
def delete(id or array) 

where(primary key -» id or array).delete all 
end 


它 使 用 不 抛 出 异常 的 where 方法 查找 记录 ， 然 后 调用 delete all 。 


delete 也 可 以 是 实例 方法 ， 比 如 : 


product = Product.first 
product.delete 


在 有 上 有 具体 实例 的 时 候 ， 可 以 这 样 使 用 ， 否 则 会 产生 NoMethodError: undefined method delete' 

for nil:NilClass'， 这 在 我 们 设计 逻辑 的 时 候 要 注意 。 

delete all 方法 和 delete 是 一 样 的 ， 直 接 发 送 数据 删除 的 命令 ， 看 一 下 api 文档 中 的 例子 : 
Post.delete all("person id = 5 AND (category = 'Something' OR category = 'Else')") 
Post.delete all(["person id - ? AND (category - ? OR category - ?)", 5, 'Something', ' 


Else']) 
Post.where(person id: 5).where(category: ['Something', 'Else']).delete all 


4.1.8.2 Destroy # I 


destroy 方法 ， 会 触发 model 中 定义 的 回调 (before remove, after remove , before destroy 
和 after destroy) ， 保 证 我 们 正确 的 操作 。 它 也 可 以 是 类 方法 和 实例 方法 ， 用 法 和 前 面 的 一 
样 。 


需要 说 明 ，delete/delete all 和 destroy/destroy all 都 可 以 作用 在 关系 查询 结果 ， 也 就 是 
(ActiveRecord::Relation) 上 ， 删 掉 查 找到 的 记录 。 


ho RAK AR 8 A GE MAE P RARE > REMI TUE 
https://github.com/radar/paranoia 这 个 gem， 他 会 给 记录 一 个 deleted at H AR # HA 
restore 方法 把 它 从 数据 库 中 恢复 过 来 ， 或 者 使 用 really_destroy! 将 它 丨 正 的 删除 掉 。 


概要 : 


本 课时 讲解 模型 在 数据 查询 时 ， 如 何 避 免 N+1 问 题 ， 使 用 scope 包装 查询 条 件 ， 编 写 模型 
Rspec 测试 。 


N+1 

Scope 

实用 的 查询 
Rspec 测试 


DD 


正文 


4.2.1 两 个 Gem 


ActiveRecord 这 个 gem 中 ， 包 含 了 两 个 重要 的 gem， 打 开 它 的 源 代码 ， 可 以 看 到 这 
gem : activemodel 和 arel » 


activemodel 为 一 个 类 增加 了 许多 特性 d 比如 属性 校 验 ? 回调 等 d 这 在 后 面 章节 会 介绍 e 


arel 是 Ruby 编写 的 sql 工具 ， 使 用 它 ， 可 以 通过 简单 的 Ruby 语法 ， 编 写 复 杂 sql 查询 ， 
我 们 上 面 使 用 的 例子 ， 语 法 就 来 自 arel。arel 还 可 以 面向 多 种 关系 型 数据 库 。 


ActiveRecord 在 使 用 arel 的 时 候 ， 提 供 了 一 个 方法 : sanitize_sql。 


在 我 们 以 上 的 讲解 中 ， 会 经 常 传递 这 样 的 参数 [name = ? and price-?", "foobar", 4] ， 它 会 
由 sanitize sql 方法 进行 处 理 ， 这 是 一 个 protected 方法 ， 我 们 使 用 send 来 调用 它 : 


Product.send(:sanitize sql, ["name = ? and price-?", "Shoes", 4]) 
-» "name - 'Shoes' and price-4" 


这 是 一 种 安全 的 手段 ， 保 护 我 们 的 sql 不 会 被 插入 恶意 代码 。 我 们 不 必 去 直接 使 用 这 个 方法 ， 
除非 特殊 情况 ， 我 们 只 需要 按照 它 的 格式 要 求 来 书写 就 可 以 了 。 


4.2.2 N+1 


N+1 是 查询 中 经 常 遇 到 的 一 个 问题 。 在 下 一 节 里 ， 我 们 经 常 使 用 关联 关系 的 查询 ， 比 如 ， 列 
出 十 个 用 户 的 同时 ， 显 示 它 地 址 中 的 电话 : 


users = User.limit(10) 
users.each do |user| 


puts user.address.phone 
end 


这 样 就 会 造成 ， 在 each 中 又 去 查询 数据 ， 得 到 电话 。 这 种 情况 会 经 常 出 现在 我 的 列表 中 ， 所 
以 在 列表 中 会 经 常 遇 到 N+1 的 问题 。 


为 了 避免 这 个 问题 ，Rails 提供 了 预 加 载 的 功能 ， 在 查询 的 时 候 ， 使 用 includes 来 解决 。 上 
面 的 例子 修改 一 下 : 


users = User.includes(:address).limit(10) 


users.each do |user| 
puts user.address.phone 
end 


我 们 查看 一 下 终端 的 输出 : 


SELECT * FROM users LIMIT 10 
SELECT addresses.* FROM addresses 
WHERE (addresses.user id IN (1,2,3,4,5,6,7,8,9,10)) 


这 里 只 有 两 个 sal 查询 ， 提 高 了 查询 效率 。 


4.2.3 查询 中 使 用 Scope 


当 我 们 使 用 where 查询 的 时 候 ， 会 遇 到 多 个 条 件 组 合 查询 。 通 常 我 们 可 以 把 它们 都 写 到 一 个 
where 的 条 件 里 ， 比 如 : 


Product.where(name: "T-Shirt", hot: true, top: true) 


我 增加 了 两 个 条 件 ， hot: true 和 top: true ， 但 是 ， 这 种 条 件 组 合 只 能 在 这 里 使 用 ， 在 其 
他 地 方 ， 我 们 还 要 再 写 一 遍 ， 这 不 符合 Rails NEE: "不 要 重复 自己 ”。 


Rails 提供 了 scope， 让 我 们 复 用 查询 条 件 : 


class Product « ActiveRecord::Base 
scope :hot, -» { where(hot: true) } 
scope :top, -» { where(top: true) } 
end 


使 用 的 时 候 ， 我 们 可 以 将 多 个 scope 组 合 在 一 起 : 


Product.top.hot.where(name: "T-Shirt") 


default scope 可 以 为 所 有 查询 加 上 它 定义 的 查询 条 件 ， 比 如 : 


class Product < ActiveRecord::Base 
default scope ( where("deleted at IS NULL") } 
end 


default scope ZEM > EA > EA (重要 的 话说 三 遍 ) ， 在 我 们 程序 变 的 复杂 的 时 候 ， 性 
能 往往 会 消耗 在 数据 库 查询 上 ， 维 护 已 有 查询 时 ， 很 容易 忽视 default scope 的 作用 。 如 果 使 
用 了 default scope， 而 在 其 他 地 方 不 得 不 去 掉 它 ， 可 以 使 用 unscoped， 然 后 再 附 上 其 他 查 
询 : 


Product.unscoped.load.top.hot 


如 果 一 个 地 方 使 用 了 某 个 scope， 而 要 在 另 一 个 地 方 把 它 的 条 件 改 变 ， 可 以 使 用 merge: 


class Product < ActiveRecord::Base 
scope :active, -» { where state: 'active' } 
scope :inactive, -» ( where state: 'inactive' } 
end 


看 一 下 它 的 执行 结果 : 


Product.active.merge(User.inactive) 
# SELECT "products".* FROM "products" WHERE "products". "state" = 'inactive' 


4.2.4 实用 的 查询 


4.2.4.1 sql 查询 集合 


我 们 使 用 where 查 询 ， 得 到 的 是 ActiveRecord::Relation 实例 ， 它 的 源 代 码 在 这 里 。 阅 读 这 里 
的 代码 ， 会 让 你 学 习 到 更 多 优雅 的 查询 方法 。 在 查询 时 ， 我 们 还 可 以 使 用 sql 直接 查询 ， 如 果 
你 更 熟悉 sql 语法 ， 可 以 这 样 来 查询 : 


Client.find by sql("SELECT * FROM clients 
INNER JOIN orders ON clients.id - orders.client id 
ORDER BY clients.created at desc") 
# => [ 
#<Client id: 1, first_name: "Lucas" >, 
#<Client id: 2, first_name: "Jan" >, 
Ba 


这 个 例子 来 自 这 里 。 


它 返 回 的 是 实例 的 集合 ， 这 在 我 们 Rails 内 使 用 很 方便 ， 但 是 提供 json 格式 的 api 时 ， 需 要 转 
换 一 下 ， 不 过 我 们 可 以 用 select all 查询， 得 到 包含 hash 的 array : 


Client.connection.select all("SELECT first name, created at FROM clients WHERE id = '1 


pao. 

# => [ 
{"first_name"=>"Rafael", "created_at"=>"2012-11-10 23:23:45.281189"}, 
{"first_name"=>"Eileen", "created_at"=>"2013-12-09 11:22:35.221282"} 


4.2.4.2 pluck 


pluck 可 以 直接 在 Relation 实例 的 基础 上 ， 使 用 sql 的 select 方法 ， 得 到 字段 值 的 集合 
(Array) ， 而 不 用 把 返回 结果 包装 成 ActiveRecord 实例 ， 再 得 到 属性 值 。 在 查询 属性 集合 
时 ， pluck 的 性 能 更 高 E 


Client.where(active: true).pluck(:id) 
SELECT id FROM clients WHERE active - 1 
-» [1, 2, 3] 


Client.distinct.pluck(:role) 
SELECT DISTINCT role FROM clients 
-» ['admin', 'member', 'guest'] 


Client.pluck(:id, :name) 


SELECT clients.id, clients.name FROM clients 
-» [[1, 'David'], [2, 'Jeremy'], [3, 'Jose']] 


ActiveRecord 有 一 个 类 似 的 方法 ，select， 比 较 下 两 者 的 区 别 : 


Product.select(:id, :name) 
Product Load (8.5ms) SELECT "products"."id", "products"."name" FROM "products" 
=> #<ActiveRecord::Relation [#<Product id: 1, name: "f">]> 
Product.pluck(:id, :name) 
(0.3ms) SELECT "products"."id", "products"."name" FROM "products" 
sep uen] 
前 者 显示 返回 AR 实例 ， 然 后 取 其 属性 值 ， 后 者 直接 读 取 数 据 库 记 录 ， 返 回 数组 。 


pluck 只 能 用 在 查询 的 最 后 ， 因 为 它 直 接 返 回 了 结果 ， 而 不 是 ActiveRecord::Relation 。 


4.2.4.3 ids 
ids 返回 主键 集合 : 


Person.ids 
-» SELECT id FROM people 


不 要 被 ids 字面 迷惑 ， 它 返回 的 是 主键 的 集合 ， 我 们 可 以 在 model 里 设 定 其 他 字段 为 主键 。 


class Person < ActiveRecord::Base 
self.primary key - "person id" 
end 


Person.ids 
-» SELECT person id FROM people 


4.2.4.4 查询 记录 数量 
这 里 有 四 个 方法 ， 方 便 我 们 判断 一 个 模型 中 的 记录 数量 。 


Client.exists?(1) 
Client.exists?(id: [1,2,3]) 
Client.exists?(name: ['John', 'Sergei']) 


exists? 判断 记录 是 否 存在 ， 和 它 类 似 的 方法 有 两 个 : 


Client.exists? [1] 
Client.any? [2] 
Client.many? [3] 
[1] 是 否 有 记录 [2] 是 否 至 少 有 一 条 记录 [3] 是 否 有 多 于 一 条 的 记录 


any? 和 many? 4 exists? 不 同 的 是 ， 他 们 可 以 使 用 在 Relation 实例 上 ， 比 如 : 


Article.where(published: true).any? 
Article.where(published: true).many? 


还 可 以 接收 block : 


person.pets.any? do |pet| 
pet.group -- 'cats' 

end 

-» false 


person.pets.many? do |pet| 
pet.group -- 'dogs' 

end 

-» true 


4.2.4.5 查询 记录 数量 
下 面 五 个 方法 ， 完 全 可 以 按照 字面 意义 理解 ， 并 且 适 用 于 Relation 上 : 


Client.count 
Client.average("orders count") 
Client.minimum( "age") 
Client.maximum( "age") 
Client.sum( "orders count") 


以 上 的 例子 来 自 这 里 ， 闲 暇 的 时 候 应 该 多 读 读 这 个 文档 ， 翻 看 源码 。 


4.2.5 Rspec 测试 


在 深入 Rails 项 目 开发 之 后 ， 测 试 环节 是 一 个 重要 的 环节 。Ruby 为 我 们 提供 了 非常 方便 的 测 


试 框 架 ，Rails 也 可 以 方便 的 执行 这 些 测 试 框架 。 


在 Rails 3.x 及 之 前 的 版 本 里 ， 上 默认 使 用 TestUnit 框架 ，4.X 之 后 改 为 MiniTest 框架 。 


以 查看 test case.rb 文件 ， 看 到 其 中 的 变化 。 
除了 这 两 个 测试 框架 ，Rspec 也 是 经 常用 到 的 Ruby 测试 框架 。 


MITE Rails 里 安装 rpesc， 和 其 他 的 几 个 gem : 


group :development, :test do 
gem 'rspec-rails' 
gem "factory girl rails" 
gem "database cleaner" 


我 们 可 


rspec-rails 是 rspec 的 Rails 集成 ， 在 Rails 中 初始 化 rspec 的 命令 是 


rails generate rspec:install 


它 会 创建 两 个 文件 ， 和 spec 文件 件 。 运 行 rpsec 测试 的 命令 非常 简单 ， rspec 就 可 以 ， 他 
会 自动 运行 spec 文件 夹 下 所 有 的 xxx spec.rb 文件 ， 也 可 以 指定 某 个 文件 : 


rspec spec/models/product spec.rb 


也 可 以 只 运行 某 一 个 测试 用 例 ， 这 需要 指定 该 用 例 开 始 的 行 数 : 


rspec spec/models/product spec.rb:10 


也 可 以 运行 某 一 个 目录 : 


rspec spec/models/ 


factory girl rails 是 factory girl 的 Rails EX » factory girl 可 以 为 我 们 的 测试 代码 提供 模拟 的 
测试 数据 。 


database cleaner 可 以 在 每 一 次 运行 测试 的 时 候 ， 清 空 测 斌 数据库。 我们 在 
config/database.yml 中 ， 会 设置 三 种 运行 环境 ，test 环境 要 单独 设置 数据 库 ， 也 就 是 因为 测 
试 时 会 反复 填 入 和 删除 数据 。 一 般 ，test 使 用 的 是 sqlite 数据 库 ， 而 production 使 用 mysql ` 
postgresql 等 数据 库 。 


我 们 需要 配置 下 spec 的 运行 环境 : 


RSpec.configure do |config| 
config.before(:each) do 
DatabaseCleaner.strategy - :truncation 
DatabaseCleaner.clean 
end 
end 


4.2.5.1 Model 测试 


在 使 用 generator 创建 model 文件 的 时 候 ，rspec 会 自动 创建 它 对 应 的 spec 文件 。 我 们 打开 
product spec.rb 文件 : 


require 'rails helper' 


RSpec.describe Product, type: :model do 
pending "add some examples to (or delete) #( FILE )" 
end 


我 们 为 它 增 加 一 个 测试 : 


RSpec.describe Product, type: :model do 
it "should create a product" do 
tshirt - Product.create(name: "T-Shirt", price: 9.99) 


expect(tshirt.name).to eq("T-Shirt") 
expect(tshirt.price).to eq(9.99) 
end 
end 
运行 一 下 这 个 测试 : 
rspec spec/models/product spec.rb 


Finished in 0.081 seconds (files took 2.37 seconds to load) 
1 example, O failures 


这 个 测试 的 目的 ， 是 确保 create 方法 可 以 为 我 们 创建 一 个 product 实例 。 更 多 rspec 语法 可 
以 查看 rspec 文档 ， 或 者 《使 用 RSpec 测试 Rails 程序 》 一 书 。 


4.3 模型 中 的 关联 关系 (Relations) 


概要 : 


本 课时 讲解 Rails 中 Model 和 Model 间 的 关联 关系 。 


An TR ANN : 


belongs_to 

has_one 

has_many 

has and belongs to many 


a BAON > 


self join 


导读 


如 果 你 对 一 对 一 关系 ， 一 对 多 关系 ， 多 对 多 关系 并 不 十 分 了 解 的 话 ， 或 者 你 对 关系 型 数据 库 
并 不 十 分 了 解 的 话 ， 建 议 你 在 阅读 下 面 的 内 容 前 ， 先 熟悉 一 下 相关 内 容 。 因 为 我 并 不 想 照 本 
宣 科 的 讲解 手册 。 我 想 讲 的 ， 是 对 它 的 理解 ， 并 且 把 我 们 的 精力 ， 放 到 设计 我 们 的 商城 中 。 


本 章 涉 及 的 知识 ， 可 以 查看 Active Record Associations， 或 者 
ActiveRecord::Associations::ClassMethods ° 


FEF RAR > AZ SE AR RRA AA © 


4.3.1 模型 间 的 关系 
在 前 面 的 章节 里 ， 我 们 为 商城 设计 了 界面 ， 并 且 使 用 了 3 个 model: 


1. User， 网 站 用 户 ， 使 用 devise 提供 了 用 户 注 册 ， 有 登录 功能 。 
2. Product? 9 sz 
3. Variant， 商 品类 型 


我 们 在 前 面 讲解 的 过 程 中 ， 已 经 提 到 了 Product 和 Variant 的 关系 。 一 个 Product 有 多 个 
Variant。 现 在 我 们 需要 增加 几 个 模型 ， 模 型 是 根据 功能 来 的 ， 我 们 的 网 店 要 增加 哪些 功能 
呢 ? 


e 当 用 户 购 买 实物 商品 的 时 候 ， 我 们 是 要 输入 它 的 收 货 地 址 (Address) ° 

e 当 用 户 选 择 商品 的 时 候 ， 选 择 不 同 的 颜色 和 大 小 ， 会 有 不 同 的 价格 (Variant) ° 

e 我 们 点 击 购买 ， 会 创建 一 个 购物 订单 (Order) ， 上 面 有 我 们 选择 的 商品 ， 应 支付 的 金 
额 ， 和 订单 的 状态 。 

e 查看 用 户 购买 的 商品 类 型 


在 我 们 的 网 店 里 ， 一 个 User 有 一 个 地 址 ， 每 次 购物 的 时 候 ， 会 读 取 这 个 地 址 作为 送 货 地 址 。 
一 个 Product 有 多 个 Variant， 每 个 Variant 保存 它 的 颜色 ， 大 小 等 属性 。 


一 个 用 户 会 有 多 个 订单 Order， 每 个 订单 会 显示 购买 的 商品 Product， 以 及 多 条 购买 记录 ， 每 
条 记录 显示 购买 的 Variant 的 每 个 数量 和 应 付 的 价格 ， 这 里 我 们 使 用 Lineltem 表示 订单 的 订 
单项 。 


4.3.2 外 键 


两 个 model 之 间 ， 通 过 外 键 进 行 关联 ，Rails 中 默认 的 外 键 名 称 是 所 属 model 的 名 称 id ， 
比如 ，User 有 一 条 Address 记录 ， 那 么 addresses 表 上 ， 需 要 增加 一 个 数字 类 型 的 字段 
user id 。 而 User 的 主键 通常 为 id 字段。 有 一 些 遗 留 的 数据 库 ， 使 用 的 外 键 可 能 不 是 按照 
Rails 默认 的 格式 ， 所 以 在 声明 外 键 关联 时 ， 需 要 指定 foreign key ° 


在 我 们 创建 Model 的 时 候 ， 可 以 在 generate 命令 上 增加 外 键 关联 ， 我 们 现在 创建 Address 
这 个 Model 


rails g model address user:references state city address address2 zipcode receiver pho 
ne 


在 创建 的 migration 文件 中 : 


create table :addresses do |t| 
t.references :user, index: true, foreign key: true 


自动 增加 了 外 键 关 联 ， 并 且 将 user. id 加 入 索引 。 如 果 是 更 改 其 他 数据 库 ， 需 要 在 migration 
文件 内 单独 设置 索引 : 


add index "addresses", ["user id"], name: "index addresses on user id" 


模型 间 的 关系 ， 都 是 通过 外 键 实 现 的 ， 下 面 我 们 详细 介绍 模型 间 的 关系 ， 并 且 实 现 我 们 商城 
的 Model ° 


4.3.3 一 对 一 关系 


一 对 一 关系 的 设 定 ， 再 一 次 体现 了 Rails 在 开发 中 的 便捷 : 


class User < ActiveRecord::Base 
has one :address 
end 


class Address « ActiveRecord::Base 
belongs to :user 
end 


在 一 对 一 关系 中 ? belongs to :user 中 3 :iuser 是 单数 ， has_one :address 中 ^ :address 
也 是 单数 。 


我 们 进入 到 console 里 来 测试 一 下 : 


user = User.first 
user.address 
-» nil 


4.3.3.1 新 建 子 资 源 
如 何 为 user 保存 address 呢 ? 


一 种 是 使 用 Address 的 类 方法 create 


Address.create(user id: user.id, ...) 

我 们 也 可 以 省 去 id 的 写法 ， 直 接 写 上 所 属 的 实例 : 
Address.create(user: user, ...) 

一 种 是 使 用 实例 方法 : 


address = Address.new 
address.user = user 
address.save 


或 者 : 


user.address = Address.create( ... ) 


这 种 方法 会 产生 两 多 SQL， 先是 insert 一 个 address 到 数据 库 ， 然 后 更 新 它 的 user id 为 刚 
才 的 user。 我 们 可 以 换 一 个 方法 : 


user.address - Address.new( ... ) 


它 只 产生 一 条 insert SQL ， 并 且 会 带 上 user id 的 值 。 


在 创建 关联 关系 时 ， 还 有 这 样 的 方法 : 


user.create address( ... ) 
user.build address( ... ) 


build xxx 相当 于 Address.new ° create xxx 也 会 产生 两 条 SQL ， 每 条 SQL 都 包含 在 一 个 
transaction 中 。 


所 以 我 们 得 出 结论 : 
把 一 个 未 保存 的 实例 ， 赋 值 给 一 对 一 关系 时 ， 它 会 自动 保存 ， 并 且 只 有 一 条 sql 产生 。 


先 create 一 个 实例 ， 再 把 赋值 给 一 对 一 关系 时 ， 是 先 保存 ， 再 更 新 ， 产 生 两 条 sql e 


4.3.3.2 保存 子 资源 


当 我 们 编写 表单 的 时 候 ， 一 个 表单 针对 的 是 一 个 资源 。 当 这 个 资源 拥有 (has_one 或 
has many) 子 资源 时 ， 我 们 可 以 在 提交 表单 的 时 候 ， 将 它 拥有 的 资源 也 保存 到 数据 库 中 。 


这 时 ， 我 们 需要 在 User 中 ， 做 一 个 声明 : 


class User < ActiveRecord::Base 

has one :address 

accepts nested attributes for :address 
end 


accepts nested attributes for 会 为 User 增加 一 个 新 的 方法 address attributes- 
(attributes) ， 这 样 ， 在 创建 User 的 时 候 : 


user hash = { email: "test@123.com", password: "123456", password confirmation: "12345 
6", address attributes: ( receiver: "Some One", state: "Beijing", city: "Beijing", pho 
ne: "123456" 3 

u = User.create(user hash) 

u.address 


只 要 保存 User 的 时 候 ， 传 递 入 Address 的 参数 ， 就 可 以 把 关联 的 address 一 并 保存 到 数据 
库 中 了 。 


更 新 记录 的 时 候 ， 也 可 以 使 用 同样 的 方法 : 


user hash = { email: "changed@123.com", address attributes: { receiver: "Other One" } 


} 


user.update(user hash) 


但 是 ， 这 里 要 注意 ， 上 面 的 方法 会 把 之 前 日 记录 的 User id 设 为 nil， 然 后 插入 一 条 新 的 记 
录 。 这 并 不 能 真正 起 到 更 新 的 作用 ， 除 非 所 有 属性 都 重新 复制 ， 不 然 ， 新 的 address 记录 只 
有 receiver 这 个 值 。 


我 们 在 accepts nested attributes for 后 增加 一 个 参数 : 


accepts nested attributes for :address, update only: true 


这 样 ，update 时 候 会 更 新 已 有 的 记录 © 
如 果 我 们 不 能 增加 update only 属性 ， 为 了 避免 创建 无 用 的 记录 ， 需 要 在 hash 里 指定 子 资 
源 的 id : 


user hash = { email: "changed@123.com", address attributes: { id: 1, receiver: "Other 
One" } 3 
user.update(user hash) 


4.3.3.3 使 用 表单 保存 子 资源 


accepts_nested_attributes_for 方法 ， 在 Form 中 有 其 对 应 的 方法 : 


<%= f.fields for :address do |address form| %> 
<%= address form.hidden field :id unless resource.new record? 95» 
«div class="form-group"> 
<%= address form.label :state, class: "control-label" %><br /> 
<%= address form.text field :state, class: "form-control" 96» 
«/div» 


<% end 96» 
打开 代码 ， 在 编辑 一 个 用 户 的 时 候 ， 我 为 它 增加 了 一 个 f.fields for 的 子 表 单 ， 对 应 了 子 
资源 的 属性 。 
我 想 ， 这 上段 代码 这 并 不 难 理解 ， 不 过 我 们 用 了 Devise 这 个 gem， 还 需要 做 一 点 额外 的 处 理 。 


打开 application_controllerrb， 我 们 需要 让 devise 支持 传 进来 新 增 的 参数 : 


class ApplicationController « ActionController::Base 
before action :configure permitted parameters, if: :devise controller? 


protected 


def configure permitted parameters 
devise parameter sanitizer.for(:sign up) { | 
rd confirmation, :address attributes) } 
devise parameter sanitizer.for(:account update) { |u| u.permit(:email, 
:current password, address attributes: [:state, :city, :addres 


u| u.permit(:email, :password, :passwo 


: password, 


:password confirmation, 
s, :address2, :zipcode, :receiver, :phone] ) } 


end 
end 


在 我 们 注册 账号 的 时 候 ， 并 没有 创建 address ， 但 是 在 编辑 的 时 候 ， 因 为 它 是 nil， 所 以 不 会 
显示 这 个 子 表单 ， 所 以 我 们 需要 在 编辑 的 时 候 创 建 一 个 空 的 address : 


views/devise/registrations/edit.html.erb 


<%= form for(resource, as: resource name, url: registration path(resource name), html: 


{ method: :put }) do |f| 965 
<% resource.build address if resource.address.nil? %> 


当然 ， 我 们 也 可 以 在 注册 的 时 候 提 供 地 址 表单 ， 大 家 不 妨 一 试 。 


4.3.3.4 删除 关联 的 子 资 源 
在 上 一 节 里 ， 我 们 介绍 了 delete 和 destroy 方法 ， 我 们 可 以 使 用 这 两 个 方法 把 关联 的 
address 删除 掉 : 


u.address.delete 
SQL (10.0ms) DELETE FROM "addresses" WHERE "addresses"."id" = ? [["id", 2]] 


或 者 : 


u.address.destroy 
(0.1ms) begin transaction 
SQL (0.7ms) DELETE FROM "addresses" WHERE "addresses"."id" = ? [["id", 3]] 


(9.2ms) commit transaction 


两 者 的 区 别 在 上 一 节 介 绍 过 ， 我 们 注意 到 ，delete 直接 发 送 数 据 库 删除 命令 ， 而 destroy 会 将 
删除 命令 放置 到 一 个 sql 的 事物 中 ， 因 为 它 会 触发 模型 中 的 回调 ， 如 果 回 调 抛 出 异常 ， 删 除 动 


作 会 失败 。 


4.3.3.5 删除 自身 同时 删除 关联 的 子 资 源 


在 删除 某 个 资源 的 时 候 ， 我 们 想 把 它 拥有 的 资源 一 并 删除 ， 这 时 ， 我 们 需要 给 has_one 方 
法 ， 增 加 一 个 参数 : 


has one :address, dependent: :destroy 


dependent 可 以 接收 五 个 参数 : 


参数 含义 
:destroy 删除 拥有 的 资源 
:delete 直接 发 送 删除 命令 ， 不 会 执行 回调 
:nullify 将 拥有 的 资源 外 键 设 为 null 


RE E 如 果 拥 有 资源 ， 会 抛 出 异常 ， 也 就 是 说 ， 当 它 has one 为 nil 
:restrict with exception 的 时 候 ， 才 能 正常 删除 它 自己 


:restrict with error 如 有 拥有 资源 ， 会 增加 一 个 errors 信息 。 


在 belongs to 上 ， 也 可 以 设置 dependent， 但 它 只 有 两 个 参数 : 


参数 含义 
:destroy 删除 它 所 属 的 资源 
:delete 删除 它 所 属 的 资源 ， 直 接 发 送 删除 命令 ， 不 会 执行 回调 


两 种 设 定 ， 出 发 角度 是 不 同 的 ， 不 过 ， 删 除 本 身 的 同时 删除 上 层 资源 是 比较 危险 的 ， 需 谨 


ue 
BH o 
pa. 


4.3.3.6 失去 关联 关系 的 子 资源 


如 果 在 has one 中 设置 了 dependent: :destroy 或 dependent: :delete ? 当 子 资源 失去 该 关 
联 关系 时 ， 它 也 会 被 删除 。 


user.address = nil 
如 果 不 设置 ， 一 个 子 资源 失去 关系 时 ， 外 键 设置 为 null 。 


4.3.3.7 子 资源 维护 


当 一 个 子 资源 失去 关联 关系 ， 和 它 在 关联 关系 中 被 删除 ， 是 一 样 的 。 我 们 在 设计 时 ， 应 尽量 
避免 产生 孤立 的 记录 ， 这 些 记 录 外 键 为 null， 或 者 所 属 的 资源 已 经 被 删除 ， 他 们 是 无 意义 的 存 
在 。 


4.3.4 一 对 多 关系 
在 电 商 系统 里 ， 一 个 用 户 是 有 多 个 订单 (Order) 的 ，User 中 使 用 的 是 has many 方法 : 


class User < ActiveRecord::Base 
has many :orders 
end 


除了 名 称 变 为 复数 形式 ， 返 回 的 结果 是 数组 ， 其 他 情形 和 "一 对 一 "是 一 样 的 。 


我 们 使 用 generate 创建 Order : 


rails g model order user:references number payment state shipment state 


number 是 订单 的 唯一 编号 ，payment state 是 付款 状态 ，Sshipment state 是 发 货 状 态 。 
payment state 的 状态 顺序 是 : pending (等 待 支付 ) "paid (已 支付 ) 。 

shipment state 的 状态 顺序 是 : pending (等 待 发 货 ) > shipped (TRH) 。 

这 两 种 状态 ， 我 们 只 做 简单 的 设计 ， 实 际 中 要 复杂 得 多 。 

开源 电 商 程序 spree 是 一 套 很 好 的 在 线 交易 程序 ， 因 为 其 开源 ， 其 中 的 概念 和 定义 对 开发 电 


商 程序 有 很 好 的 启发 。 它 的 源 代码 在 这 里 ， 目 前 是 最 新 版 本 是 3.0.2.beta ^ 


4.3.4.1 添加 子 资 源 
一 对 多 关系 返回 的 ， 是 CollectionProxy 实例 。 
当 添 加 一 对 多 关系 时 ， 可 以 很 "形象 "的 使 用 : 


product.variants «« Variant.new 
product.variants «« [Variant.new, Variant.new] 


执行 << 的 时 候 ，variant 的 product id 会 自动 保存 为 product.id » 


如 果 variant 是 一 个 未 保存 到 数据 库 的 实例 ，<< 执行 的 时 候 会 自动 将 它 保 存 ， 并 且 赋 子 它 
product id 值 。 这 是 一 步 完成 的 ， 只 有 一 条 SQL» 


但 是 ， 如 果 是 下 面 的 情形 : 


product.variants << Variant.create 


会 把 variant 先 保存 到 数据 库 ， 然 后 再 更 新 它 的 product id 字段 


» 


这 会 产生 两 条 SQL ° 


这 里 也 可 以 使 用 build 方法 ， 和 上 面 " 一 对 一 关系 "不同 的 是 ， 它 需要 在 collection 上 执行 : 


variant = product.variants.build( ... ) 
variant.save 


build 返回 的 是 一 个 未 保存 的 实例 。 查看 product.variants ， 会 看 到 它 包含 了 一 个 未 保存 的 
variant (ID 为 nil) 。 


另 一 种 情 形 


product.variants.build( ... ) 
product.save 


当 这 个 product.save 的 时 候 ， 这 个 variant 也 会 保存 到 数据 库 中 。 


4.3.4.2 删除 子 资 源 
| 除 资源 的 时 候 ， 可 以 使 用 几 个 方法 : 


product.variants.delete(...) 
product.variants.destroy(...) 
product.variants.clear 


delete TA 3E BL ES ^ mæ thh (product id) 3X JJ nil, 而 destroy 4 3E 44 A] 
除 掉 它 并 出 发 回调 。 


他 们 都 可 以 传递 进 一 个 实例 ， 或 者 实例 的 集合 ， 而 并 不 管 这 个 实例 是 否 真 的 属于 它 。 


product.variants.delete(Variant.find(1)) 
product.variants.delete(Variant.find(1,2,3)) 


这 样 是 不 是 太 霸 道 了 ? 所 以 ， 建 议 用 第 三 个 方法 更 稳妥 些 。clear 方法 会 把 外 键 置 为 nil 。 


如 果 再 has many 上 声明 了 dependent: :destroy ° AA destroy 方式 把 它们 删除 (A 
调 ) 。 如 果 声 明 的 是 dependent: :delete all ， 会 用 delete 方法 〈 跳 过 回调 ) 。 这 和 一 对 一 
中 描述 是 一 致 的 。 


注意 : 
has many 和 has one 上 的 dependent 选项 ， 适 用 以 下 两 种 情形 


e 删除 自身 时 ， 如 何 处 理子 资源 
o 当 子 资源 失去 该 关联 关系 时 ， 如 何 处 理 该 子 资 源 


我 们 来 看 下 一 节 。 
4.3.4.3 更 改 子 资源 
当 改 动 关系 的 时 候 ， 可 以 直接 使 用 = ， 假 设 我 们 有 ID 为 1，2，3，4 的 Variant : 


product.variants = Variant.find(1,2) 


时 会 自动 把 ID:1，1D:2 的 product id 外 键 设 为 null 。 


这 
再 次 选择 ID:3，1D:4 的 variant : 


product.variants = Variant.find(3,4) 


会 自动 把 1D:3，1ID:4 的 product id 外 键 设置 为 product.id ° 


如 果 在 has many 设置 了 dependent: :destroy ， 当 UD:1 和 ID:2 失去 关联 的 时 候 ， 会 把 它 
们 从 数据 库 中 删除 掉 。 这 与 has one 中 的 dependent 选项 是 一 样 的 。 详 见 本 章 前 面 4.3.3.4 


删除 自身 同时 删除 关联 的 子 资源 。 


4.3.4.4 counter cache 
“一 对 多 ”关系 中 ， belongs to 方法 可 以 增加 counter cache 属性 : 


class Order < ActiveRecord::Base 
belongs to :user, counter cache: true 
end 


这 时 ， 我 们 需要 给 users 表 增 加 一 个 字段 : orders_count， 当 我 们 把 一 个 order 保存 到 一 对 多 
的 关系 中 时 ，orders_count 会 自动 +1， 当 把 一 个 资源 从 关系 中 删除 ， 该 字段 会 -1。 如 此 我 们 
不 必 去 增加 计算 一 个 user 有 多 少 个 orders， 只 需要 读 该 字段 就 可 以 了 。 


向 Users 表 添 加 orders_count 字段 : 


rails g migration add orders count to users orders count:integer 





4.3.4.5 $ 4 
当 一 个 资源 可 能 属于 多 种 资源 时 ， 可 以 用 到 多 态 。 举 个 林子 : 


商品 可 以 评论 ， 文 章 可 以 评论 ， 而 评论 model 对 任何 一 个 资源 都 是 一 样 的 功能 ， 所 以 ， 评 论 
在 belongs to 的 后 面 ， 增 加 : 


class Comment « ActiveRecord::Base 
belongs to :commentable, polymorphic: true 
end 


Comment 的 迁移 文件 ， 也 相应 的 增加 设 定 : 


t.references :commentable, polymorphic: true, index: true 


如 果 是 手动 添加 字段 ， 需 要 这 样 来 写 : 


t.string :commentable type 
t.integer :commentable id 


说 明 ， 查 找 一 个 多 态 资源 时 ， 是 根据 拥有 者 的 类 型 (type， 一 般 是 它 的 类 名 称 ) fe ID 进行 匹 
He by o 


拥有 评论 的 model， 也 需要 改动 下 : 


class Product < ActiveRecord::Base 
has many :commentable, as: :commentable 
end 


class Topic « ActiveRecord::Base 
has many :commentable, as: :commentable 
end 


多 态 并 不 局 限于 一 对 多 关系 ， 一 对 一 也 同样 适用 。 


4.3.5 中 间 模 型 和 中 间 表 


has one # has_many， 是 两 个 model 间 的 操作 。 我 们 可 以 增加 一 个 中 间 模 型 ， 描 述 之 前 两 
个 model 间 的 关系 。 


4.3.5.1 中 间 模 型 


我 们 先 创 建 订 单项 (Lineltem) 这 个 model， 它 属于 一 个 订单 ， 也 属于 一 个 商品 类 型 
(Variant) 。 


rails g model line item order:references variant:references quantity:integer 


对 于 一 个 订单 ， 我 们 有 多 个 订单 项 ， 对 于 一 个 订单 项 ， 会 关联 购买 的 具体 商品 类 型 ， 那 么 ， 
一 个 订单 拥有 的 商品 类 型 ， 就 可 以 通过 through 查找 到 。 


class Order « ActiveRecord::Base 
belongs to :user, counter cache: true 
has many :line items 
has many :variants, through: :line items 
end 


class LineItem < ActiveRecord::Base 
belongs to :order 
belongs to :variant 

end 


我 们 进 到 终端 里 进行 查找 : 


order = Order.first 

order.variants 

-» SELECT "variants".* FROM "variants" INNER JOIN "line items" ON "variants"."id" - "l 
ine items". "variant id" WHERE "line items"."order id" = ? [["order id", 1]] 

=> #sActiveRecord: :Associations::CollectionProxy []» 


* UE $| * through 为 使 用 了 inner join 的 sql 语法 。 


Lineltem 是 两 个 模型 ，Order 和 Variant 的 中 间 模 型 ， 它 表示 订单 中 的 每 一 项 。 但 是 ， 中 间 模 
型 不 一 定 要 使 用 两 个 belongs_to 连接 两 边 的 模型 ， 比 如 : 


class User < ActiveRecord::Base 

has many :orders 

has many :line items, through: :orders 
end 


进 到 终端 ， 我 们 查看 一 个 用 户 有 哪些 订单 项 : 


user = User.first 

user.line items 

-» SELECT "line items".* FROM "line items" INNER JOIN "orders" ON "line items"."order 
id" = "orders"."id" WHERE "orders"."user id" = ? [["user id", 1]] 


从 左边 可 以 查 到 右边 资源 ， 那 么 ， 可 以 通过 中 间 表 ， 从 右边 查找 左边 资源 么 ? 


我 们 给 Variant 增加 关联 : 


class Variant « ActiveRecord::Base 
belongs to :product 
has many :line item 
has many :orders, through: :line item 
end 


进入 终端 : 


v = Variant.last 


v.orders 
-» SELECT "orders".* FROM "orders" INNER JOIN "line items" ON "orders"."id" - "line it 
ems"."order id" WHERE "line items". "variant id" = ? [["variant id", 2]] 


因为 中 间 表 Lineltem 拥有 两 边 的 外 键 ， 所 以 可 以 查找 variant 的 orders ° 124 orders 上 没有 
line item id 字段 ， 因 为 这 不 符合 我 们 的 业务 逻辑 ， 所 以 无 法 查找 line_item.user。 如 果 需 要 
查找 ， 可 以 给 line_item 上 增加 user id 字段 。 


class LineItem < ActiveRecord::Base 
belongs to :order 
belongs to :variant 
belongs to :user 

end 


4.3.5.2 "P IR 


中 间 模 型 的 作用 ， 除 了 连接 两 端 模型 外 ， 更 重要 的 是 ， 它 保存 了 业务 中 属于 中 间 模 型 的 数 
据 ， 比 如 ， 订 单项 中 的 quantity 字段 。 如 果 模 型 不 必 或 者 没有 这 种 字段 ， 可 以 不 用 增加 
model， 而 直接 使 用 中 间 表 。 


我 们 有 一 个 功能 : 保存 用 户 购 买 的 商品 类 型 。 这 时 可 以 使 用 中 间 表 ， 保 存 购买 关系 。 


中 间 表 具有 两 端 模型 的 外 键 。 两 端 模型 使 用 has and belongs to many 方法 (简写: 
HABTM) 。 


在 创建 中 间 表 的 时 候 ， 也 可 以 使 用 migration， 如 果 在 表 名 中 包含 JoinTable 字样 ， 会 自动 创 
建 中 间 表 : 


rails g migration CreateJoinTable users variants:uniq 


运行 rake db:migrate ， 查 看 Schema.rb : 


create table "users variants", id: false, force: :cascade do |t| 


t.integer "user id", null: false 
t.integer "variant id", null: false 
end 


add index "users variants", ["variant id", "user id"], name: "index users variants on. 
variant id and user id", unique: true 


调整 一 下 User fe Variant model : 


class User « ActiveRecord::Base 


has and belongs to many :variants 
end 


class Variant « ActiveRecord::Base 


has and belongs to many :users 
end 


在 终端 里 测试 : 


user.variants 


=> SELECT "variants".* FROM "variants" INNER JOIN "users variants" ON "variants"."id" 
- "users variants"."variant id" WHERE "users variants"."user id" - ? [["user id", 1]] 


variant.users 


=> SELECT "users".* FROM "users" INNER JOIN "users variants" ON "users"."id" = "users 
variants"."user id" WHERE "users variants". "variant id" = ? [["variant id", 2]] 


利用 中 间 表 ， 实 现 了 多 对 多 关系 。 


查看 一 个 用 户 购买 了 哪些 
系 o 


4.3.5.3 7 关系 

商品 类 型 ， 和 查看 一 个 商品 类 型 被 哪些 用 户 购 买 ， 这 就 是 多 对 多 关 
保存 和 删除 多 对 多 关系 ， 和 一 对 多 关系 的 操作 是 一 样 的 。 因 为 我 们 在 创建 migration 时 ， 增 加 
了 索引 唯一 校 验 ， 在 操作 时 要 做 好 异常 处 理 ， 或 者 保存 前 进行 判断 。 


user.variants «« variant 
user.variants «« variant 


-» SQLite3::ConstraintException: columns variant id, user id are not unique: 


4.3.5.4 inner join 


ActiveRecord 在 查询 关联 关系 时 ， 使 用 的 是 inner join 查询 ， 我 们 可 以 单独 使 用 join 7r 
法 ， 实 现 该 查询 。 


比如 ， 一 个 简单 的 join 查询 : 


96 Order.joins(:line items) 
-» SELECT "orders".* FROM "orders" INNER JOIN "line items" ON "line items"."order id" 
- "orders"."id" 


也 可 以 查询 多 个 关联 的 : 


% Order.joins(:line items, :user) 
-» SELECT "orders".* FROM "orders" INNER JOIN "line items" ON "line items"."order id" 
- "orders"."id" INNER JOIN "users" ON "users"."id" - "orders"."user id" 


ADAE XS: 


96 Order.joins(line items: [:variant]) 
-» SELECT "orders".* FROM "orders" INNER JOIN "line items" ON "line items"."order id" 
- "orders"."id" INNER JOIN "variants" ON "variants"."id" - "line items"."variant id" 


但 是 ， 在 一 些 更 复杂 的 查询 中 ， 我 们 需要 改变 inner join 查询 为 left join 或 right 


join 


User.select("users.*, orders.*").joins("LEFT JOIN "orders? ON orders.user id = users.i 
d") 


这 时 返回 的 是 全 部 用 户 ， 即 便 它 没有 订单 。 这 在 生成 一 些 报 表 时 是 有 用 的 。 


4.3.6 自 连 接 


在 设计 模型 的 时 候 ， 一 个 模型 即 可 以 是 Catalog (类 别 ) ， 也 可 以 是 Subcatalog (FX 
$1) ， 我 们 为 网 店 添加 xm Model : 


rails g model catalog parent catalog:references name parent:boolean 


看 一 下 catalog.rb : 


class Catalog « ActiveRecord::Base 
has many :subcatalogs, class name: "Catalog", foreign key: "parent catalog id" 
belongs to :parent catalog, class name: "Catalog" 
has many :products 

end 


Yi 


这 样 ， 我 们 可 以 实现 分 类 ， 也 可 以 吧 商 品 加 入 到 某 个 分 类 中 。 


4.3.7 双向 关联 
我 们 查找 关联 关系 的 时 候 ， 是 可 以 在 两 边 同 时 查找 ， 比 如 : 


class User < ActiveRecord::Base 
has one :address 
end 


class Address « ActiveRecord::Base 


belongs to :user 
end 


我 们 可 以 user.address * WT YA address.user ， 这 叫做 Bi-directional ， 双 向 关联 。 (和 它 
相反 ，Uni-directional， 单 向 关联 ) 


但 是 ， 这 在 我 们 的 内 存 查找 中 ， 会 引起 问题 : 


u = User.first 
a - u.address 


u.email -- a.user.email 
=> true 
u.email = "a@1.com" 
u.email -- a.user.email 
-» false 

原因 是 : 


u.object id 

=> 70241969456560 
a.user.object id 
=> 70241969637580 


两 个 类 并 不 是 在 内 存 中 指向 同一 个 地 址 ， 他 们 是 不 同 的 两 个 类 。 


为 了 避免 这 个 问题 ， 我 们 需要 使 用 inverse of : 


class User « ActiveRecord::Base 
has one :address, inverse of: :user 


end 


class Address « ActiveRecord::Base 
belongs to :user, inverse of: :address 


end 


4 model 的 关联 关系 上 ， 已 经 有 polymorphic > through > as 时 ， 可 以 不 用 加 inverse_of， 它 
自然 会 指向 同一 个 object， 大 家 可 以 使 用 user 和 order 之 间 的 关联 验证 。 对 于 user 和 
address 之 间 ， 还 是 应 该 加 上 inverse of 选项。 


4.3.8 Rspec 测 会 


关联 关系 的 测试 ， 可 以 使 用 shoulda-matchers 这 个 gem ° €X Rails 的 模型 间 关 联 提供 了 方 
便 的 测试 方法 。 


比如 : 


RSpec.describe User, type: :model do 
it ( should have many(:orders) 3 
end 


RSpec.describe Order, type: :model do 


it ( should belong to(:user) } 
end 


更 多 模型 间 关 联 关 系 测试 的 方法 ， 可 以 查看 ActiveRecord matchers 


4.4 模型 中 的 校 验 (Validates ) 


概要 : 


本 课时 讲解 Model 中 的 属性 校 验方 法 ， 以 及 在 页 面 上 显示 校 验 失 败 信息 。 


知识 点 : 


. validates 方法 
errors 

. helpers 

118n 

Rspec 


ak WN > 


正文 


4.4.1 数据 校 验 


我 们 将 数据 保存 到 数据 库 的 时 候 ， 可 以 有 两 种 数据 校 验 ， 一 种 是 在 数据 库 中 设 定 验证 规则 ， 
一 种 是 在 程序 中 进行 校 验 。 
Rails 为 我 们 提供 了 方便 的 属性 校 验 o 在 [4.2.1 两 个 Gem] 二 各 ; 我 们 介绍 SAGABAL à 


包含 的 两 个 Gem， 在 数据 查询 和 关联 关系 中 ， 我 们 主要 使 用 的 是 arel。 数 据 校 验 时 ， 我 们 使 
用 的 是 ActiveModel。 


4.4.2 校 验 方法 


4.4.2.1 常用 的 校 验 方法 


方法 


acceptance 


validates_associated 


confirmation 


exclusion 


format 


inclusion 


length 
numericality 


presence 


absence 
uniqueness 
注解 : 


[1] 


含义 
必须 接受 选项 ， 比 如 
注册 条 款 (必须 同 


意 ) 
ANLE 


校 验 关联 资源 ， 仅 在 
关联 的 一 端 使 用 即 
LES TA PIT 


TED 
排除 内 容 ， 如 某 些 保 
留 关 键 词 不 允许 注册 
使 用 


格式 化 ， 如 邮件 格式 


包含 内 容 ， 如 特定 的 
输入 内 容 


仅 数字 


必 填 ， 使 用 blank? 
方法 判断 


必 空 ， 使 用 
present? 判断 


唯一 


class Library < ActiveRecord::Base 


has many :books 


validates associated :books 


end 


[2] 有 其 他 几 个 选项 : 


例子 


validates :terms of service, 
acceptance: true 


[1] 


validates :email, confirmation: true 


validates :subdomain, exclusion: ( in: 
%w(www US Ca jp), message: "Yo 
(value) is reserved." ) 


validates :legacy code, format: { with: 
AA[a-zA-Z]*Mz/, message: "only allows 
letters" ) 


validates :size, inclusion: ( in: 
%w(small medium large), message: 
"%{value} is not a valid size" } 


validates :name, length: ( minimum: 2 


[2] 
validates :points, numericality: true 


validates :name, :login, :email, 
presence: true [3] [4] 


[5] 


validates :email, uniqueness: true [6] 


‘minimum * RAK :maximum， 最 大 长 度 :in/:within， 在 茶 范围 :is， 指 定 长 度 


[3] 也 可 以 应 用 在 关联 关系 上 ， 如 : 


class LineItem < ActiveRecord::Base 
belongs to :order 
validates :order, presence: true 
end 


为 了 保持 内 存 中 引用 相同 地 址 ， 需 要 在 Order 上 使 用 inverse of : 


class Order < ActiveRecord::Base 
has many :line items, inverse of: :order 
end 


[4] 进入 console， 做 个 试验 : 


false.blank? 
=> true 
true.blank? 


-» false 


所 以 ， 使 用 presence 判断 true/false 属性 时 ， 需 要 这 样 使 用 : 


validates :boolean field name, presence: true 
validates :boolean field name, inclusion: ( in: [true, false] ) 
validates :boolean field name, exclusion: { in: [nil] } 


[5] 和 presence 一 样 ， 需 要 使 用 inverse of 限定 关联 关系 ， 并 且 在 判断 true/false 时 : 


validates :boolean field name, absence: true 
validates :boolean field name, exclusion: { in: [true, false] } 


[6] uniqueness 有 两 个 重要 的 选项 。 


scope” Hite : 


validates :number, uniqueness: { scope: : company_id } 


保存 到 数据 库 前 ，uniqueness 会 先 检索 数据 库 是 否 已 经 存在 该 字段 的 值 ，scope 可 以 使 检索 
时 附带 一 个 字段 ， 比 如 : 不 同 的 公司 ， 可 以 有 相同 的 订单 号 ， 而 同 公 司 订 单 号 必须 唯一 。 


validates :name, uniqueness: { case sensitive: false } 


默认 是 true， 区 分 大 小 写 。 改 为 false， 可 不 区 分 大 小 写 。 


4.4.2.2 校 验方 法 中 的 选项 


在 检验 方法 validates 中 ， 可 以 使 用 几 个 选项 : 


选项 含义 例子 
allow nil 是 否 允 许 为 nil validates :size, allow. nil: true 
是 否 人 允许 为 blank? > A 
allow blank false > ARTE "", validates :title, allow blank: true 


false , nil 


validates :subdomain, exclusion: ( in: 
message 自 定 义 错 误 信 息 %w(www us ca jp), message: "%{value} 
为 保留 关键 词 "} 


en 选择 在 create 或 update validates :email, uniqueness: true, on: 
上 使 用 校 验 :create 
paa 校 验 失败 时 抛 出 异常 ， 或 validates :name, presence: ( strict: true } 
自 定 异 常 类 [1] 
注解 
[1] 


自 定义 异常 类 


class Person < ActiveRecord::Base 
validates :token, presence: true, uniqueness: true, strict: TokenGenerationException 
end 


Person.new.valid? 
-» TokenGenerationException: Token can't be blank 


4.4.3 触发 校 验方 法 


在 将 数据 保存 到 数据 库 的 时 候 ， 有 些 方法 ， 会 触发 校 验 ， 有 些 则 直接 发 送 数据 库 sq| 命令， 不 
触发 校 验 。 


4.4.3.1 触发 校 验 的 方法 


e create 

e create! 
e save 

e save! 

e update 
e update! 


| 结尾 的 方法 ， 在 校 验 失败 时 ， 会 抛 出 异常 。 save(validate: false) 可 以 跳 过 save 方法 的 


4.4.3.2 不 触发 校 验 的 方法 


e decrement! 

e decrement counter 
e increment! 

e increment counter 
e toggle! 

e touch 

e update all 

e update attribute 
e update column 

e update columns 
e update counters 


4.4.3.2 有 条 件 的 校 验 
我 们 可 以 在 校 验 中 增加 :if 或 unless 条 件 判断 。 


class Order < ActiveRecord::Base 
validates :card number, presence: true, if: :paid with card? 
def paid with card? 
payment type -- "card" 
end 
end 


这 里 使 用 的 是 方法 判断 ， 也 可 以 直接 使 用 字符 串 ， 比 如 : 


class Person < ActiveRecord::Base 
validates :surname, presence: true, if: "name.nil?" 
end 


或 者 一 个 代码 块 : 


class Account < ActiveRecord::Base 
validates :password, confirmation: true, unless: Proc.new { |a| a.password.blank? } 
end 


4.4.3.3 valid? 方法 


valid? 和 invalid? 方法 会 触发 校 验 。 校 验 成 功 时 返回 true， 失 败 时 ， 返 回 false， 并 且 将 
校 验 信息 放 入 errors 类 。 访 问 order.errors ， 返 回 的 是 ActiveModel::Errors 实例 ， 它 的 代 
码 在 过 里 。 


4.4.4 Errors 对 象 


校 验 失败 时 ，model.errors 会 保存 入 校 验 的 属性 和 失败 原因 。 我 们 可 以 通过 几 个 方法 ， 从 
errors 实例 中 拿 到 具体 的 信息 。 


% model.errors.messages 
=> {:number=>["must be blank"]} 


messages 方法 返回 的 是 hash 结构 的 信息 ，key 是 校 验 的 属性 。 


96 model.errors.full messages 
-» ["Number can't be blank", ...] 


full messages 方法 返回 Array 结构 的 完整 错误 信息 。 这 在 资源 编辑 的 form 页 面 ， 可 以 整体 
输出 错误 信息 ， 不 过 它 没 有 具体 到 茶 个 属性 上 。 对 于 某 个 属性 ， 我 们 可 以 使 用 


errors[:number] 来 读 取 : 


96 order.errors[:number] 
-» ["can't be blank"] 


在 某 些 时 候 ， 我 们 需要 添加 自己 的 信息 ， 可 以 使 用 : 
order.errors.add(:number，" 订 单 号 不 能 含有 !@#%*( )_-+= 等 字符 ") 
如 果 添 加 的 信息 ， 并 不 一 定 是 某 个 具体 属性 ， 可 以 添加 到 errors 的 base 中 : 


order.errors.add(:base，" 订 单 格式 不 正确 ") 


order.errors.clear ， 可 以 清理 掉 所 有 信息 . 


- 


> 


4.4.5 使 用 中 文 的 校 验 信息 


我 们 已 经 注意 到 了 ， 目 前 所 有 的 校 验 信息 都 是 英文 的 ， 虽 然 可 以 在 自 定义 信息 里 写 入 中 文 
(Not Rails Style) ， 但 是 我 们 可 以 利用 Rails 提供 的 118n gem， 实 现 文本 内 容 的 汉化 。 这 
括 异常 信息 。 


(Gy 


我 们 先 修改 一 下 118n 文件 加 载 地 址 ， 在 application.rb 文件 里 ， 我 们 找到 这 一 段 : 


config.i18n.load path += Dir[Rails.root.join('config', 'locales', '**/*.{rb,yml}').to_ 
s] 
config.i18n.default locale = :"zh-CN" 


这 样 会 加 载 我 们 在 config/locales 中 的 全 部 语言 包 文件 (注意 ， 这 里 使 用 的 是 **/*， 
(rb,yml) ) 。 


我 们 创建 语言 包 ， 为 了 便于 维护 ， 我 在 这 里 做 了 细 分 ， 大 家 可 以 在 这 里 查看 。 


进 到 终端 里 ， 测 试 下 : 


% product = Product.new 

96 product.valid? 

-» false 

96 product.errors.full messages 


=> [" 名 称 不 能 > 空 字符 "] 


在 后 面 的 章节 里 ， 会 专门 讲解 118n 的 问题 ， 如 果 不 像 本 例子 中 自己 添加 语言 包 
rails-i18n 这 个 gem 来 解决 问题 。 


(= 
E 
x 
Paa! 
ye 


` 


4.4.5.1 页 面 中 显示 错误 信息 


为 了 让 页 面 集中 的 显示 错误 信息 ， 我 们 在 form 中 使 用 了 局 部 模板 ， 把 校 验 失败 的 内 容 显 示 在 
输入 框 的 顶部 。 


<% if @product.errors.any? %> 
«div id-"error expl" class-"panel panel-danger"> 
«div class="panel-heading"> 
«h3 class="panel-title"><%= pluralize(@product.errors.count, "error") %> prohibi 
ted this product from being saved:</h3> 
«/div» 
«div class="panel-body"> 
«ul» 
<% Qproduct.errors.full messages.each do |msg| 96» 
<li><%= msg %></1li> 
<% end %> 
</ul> 
</div> 
</div> 
<% end %> 


full messages 返回 Array RITA. RAR SURE] o de GRE d AGES GR LA 
信息 ， 可 以 单独 读 取 该 属性 ， 比 如 @product.errors[:name] ， 可 以 放 到 一 个 jquery 的 tooltip 
中 。 


不 过 ， 这 种 信息 是 要 提交 到 服务 器 端 处 理 后 ， 才 能 显示 出 来 的 。 为 了 在 页 面 端 就 显示 校 验 ， 
我 们 还 是 需要 jQuery 插件 的 。 


4.4.5.2 jQuery 校 验 
Form 校 验 的 时 候 ， 有 两 个 插件 较 常 用 。 


http://jqueryvalidation.org/ 是 较 常 用 的 一 个 ， 也 很 简单 ， 但 是 需要 在 页 面 上 显示 中 文 ， 还 需要 
它 的 中 文 插件 。 


<%= javascript include tag 'spree/jquery.validate/localization/messages zh' %> 


中 文 语言 包 的 源码 在 [这 里 ] (https://github.com/jzaefferer/jquery- 
validation/blob/master/src/localization/messages zh.js)° 


如 果 不 需要 校 验 具体 信息 ， 因 为 我 们 已 经 使 用 了 bootstrap 这 个 前 端 框架 ， 所 以 我 们 可 以 使 用 
它 的 表单 校 验 : http://bootstrapvalidator.com 


它 会 按照 bootstrap 的 方式 ， 将 输入 框 加 上 图 标 ， 使 校 验 更 加 直观 。 当 然 ， 你 还 可 以 读 取 具体 
的 属性 信息 ， 放 到 bootstrap 的 tooltip 里 。 


4.4.6 Rspec 
和 上 一 张 的 关联 关系 一 样 ，shoulda-matchers 也 提供 了 方便 的 校 验 测试 框架 。 


describe Product do 
it ( should validate presence of(:name) } 
end 


现在 我 们 给 Model 增加 了 越 来 越 多 的 内 容 ， 为 了 方便 找到 方法 ， 我 们 可 以 对 代码 进行 一 个 简 
单 的 分 割 ， 这 样 就 不 会 在 测试 和 对 应 的 业务 代码 间 切 换 浪费 时 间 了 。 
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4.5 模型 中 的 回调 (Callback) 


概要 : 


本 课时 将 讲解 ActiveRecord 中 常用 的 回调 方法 。 


Fate m o: 


ActiveModel 中 的 回调 
ActiveRecord 中 的 回调 
编写 回调 

触发 回调 

使 用 回调 计算 库存 


a BAON > 


正文 


4.5.1 ActiveModel 中 的 回调 


ActiveModel 提供 了 多 个 实用 的 功能 ， 它 可 以 让 一 个 普通 的 类 ， 具 备 如 属性 校 验 ， 回 调 ， 显 示 
字段 |18n 值 等 众多 功能 。 


比如 ， 我 们 可 以 为 Person 类 增加 了 一 个 回调 方法 : 


class Person 
extend ActiveModel::Callbacks 
define model callbacks :create 
end 


所 谓 回 调 ， 是 指 在 某 个 方法 前 〈before) 、 后 (after) 、 前 后 (around) ， 执 行 某 个 方法 。 
上 面 的 例子 里 ，Person 拥有 了 三 个 标准 的 回调 方法 : before create ` after. create ^ 
around create ° 


我 们 还 需要 为 这 个 回调 方法 增加 逻辑 代码 : 


class Person 
extend ActiveModel::Callbacks 
define model callbacks :create 


# 定义 create 方法 代码 
def create 
run callbacks :create do 
puts "I am in create method." 
end 
end 


# 开始 定义 回调 
before create :action before create 
def action before create 
puts "I am in before action of create." 
end 


after create :action after create 
def action after create 

puts "I am in after action of create." 
end 


around create :action around create 
def action around create 
puts "I am in around action of create." 
yield 
puts "I am in around action of create." 
end 
end 


进入 到 Rails 的 终端 里 ， 我 们 测试 下 这 个 类 : 


96 rails c 

» person - Person.new 

> person.create 

I am in before action of create. 
I am in around action of create. 
I am in create method. 

I am in around action of create. 
I am in after action of create. 


在 ActionModel 中 有 许多 的 Ruby 元 编程 知识 ， 如 果 你 感 兴趣 ， 可 以 读 一 读 《Ruby 元 编程 
(第 二 版 ) 》 这 本 书 。 


ActiveRecord 中 的 回调 将 常用 的 find ， create ， update ， destroy 等 方法 进行 包装 。 


Rails 在 controller 也 有 回调 ， 我 们 下 一 章 会 介绍 。 


4.5.2 ActiveRecord 中 的 回调 


我 们 在 Rails 中 使 用 的 Model 回调 ， 是 通过 调用 ActiveRecord 中 定义 的 实例 方法 来 实现 
的 > Hike before_validation 方法 实现 了 在 validate 方法 前 的 回调 。 


所 谓 回调 ， 就 是 在 目标 方法 上 ， 再 执行 其 他 的 方法 代码 。 
ActiveRecord 提供 了 众多 回调 方法 ， 包 含 了 一 个 model 实例 在 数据 库 操 作 中 的 各 个 时 期 。 按 


照 数 据 库 操作 的 不 同 ， 可 以 将 它们 划分 为 五 种 情形 的 回调 方法 。 


第 一 种 ， 创 建 对 象 时 的 回调 。 


before validation 


after validation 

e before save 

e around save 

e before create 

e around create 

e after create 

e after save 

e after commit/after rollback 


第 二 种 ， 更 新 对 象 时 的 回调 。 


e before validation 

e after validation 

e before save 

e around save 

e before update 

e around update 

e after update 

e after save 

e after commit/after rollback 


第 三 种 ， 删 除 对 象 时 的 回调 。 


e before destroy 

e around destroy 

e after destroy 

e after commit/after rollback 


第 四 种 ， 初 始 化 和 查找 时 的 回调 。 


e after find 


e after initialize 
after initialize 会 在 一 个 实例 使 用 new 创建 ， 或 从 数据 库 读 取 时 和 触 发。 这样 避免 直接 履 写 实例 
的 initialize 方法 。 
当 从 数据 库 读 取 数据 时 ， 会 触发 after find 回调 : 


e all 

e first 

e find 

e find by 

e findby* 

e findby"! 

e find by sql 
e last 


after find 执行 优先 于 after_initialize ° 


第 五 种 ，touch 回调 。 


e after touch 


执行 实例 的 touch 方法 触发 该 回调 。 


回调 执行 顺序 


我 们 观察 一 下 以 上 每 个 回调 的 执行 的 顺序 ， 这 里 做 一 个 简单 的 例子 : 


class Product « ActiveRecord::Base 
before validation do 
puts "before validation" 
end 


after validation do 
puts "after validation" 
end 


before save do 
puts "before save" 
end 


around save :test around save 
def test around save 
puts "begin around save" 
yield 
puts "end around save" 
end 


before create do 
puts "before create" 
end 


around create :test around create 
def test around create 
puts "begin around create" 
yield 
puts "end around create" 
end 


after create do 
puts "after create" 
end 


after save do 
puts "after save" 
end 


after commit do 
puts "after commit" 
end 


after rollback do 
puts "after rollback" 
end 
end 


进入 终端 试验 下 : 


product - Product.new(name: "TTT") 
product.save 
(0.1ms) begin transaction 
before validation 
after validation 
before save 
begin around save 
before create 
begin around create 
SQL (0.6ms) INSERT INTO "products" ("name", "created at", "updated at") VALUES (?, 
Br R [["name", "TTT"], ["created at", "2015-06-16 02:49:20.871384"], ["updated at", 
"2015-06-16 02:49:20.871384"]] 
end around create 
after create 
end around save 
after save 
(0.7ms) commit transaction 
after commit 
-» true 


TRAE] create 回调 是 最 接近 sql 执行 的 ， 并 且 validation ` save ` create 回调 被 包含 在 一 
个 transaction 事务 中 ， 最 后 ， 是 after commit 回调 。 


我 们 在 设计 逻辑 的 过 程 中 ， 需 要 了 解 它 执行 的 顺序 。 当 需要 在 回调 中 操作 保存 到 数据 库 后 的 
实例 ， 需 要 把 代码 放 到 在 after commit Po 


4.5.3 Jm 5 L1] 


上 面 列 出 的 ， 是 回调 的 方法 名 ， 我 们 还 需要 编写 具体 的 回调 代码 。 
4.5.3.1 符号 和 方法 


class Topic < ActiveRecord::Base 
before destroy :delete parents [1] 


private [2] 
def delete parents [3] 
self.class.delete all "parent id = #{id}" 
end 
end 


[1] 用 符号 定义 回调 执行 的 方法 名 称 [2] private 或 protected 方法 均 可 作为 回调 执行 方法 [3] 4A 
行 的 方法 名 ， 和 定义 的 符号 一 至 


对 于 round 回调， 我 们 需要 在 方法 中 使 用 yield ， 上 面 的 例子 已 经 看 到 : 


around create :test around create 
def test around create 
puts "begin around create" 
yield 
puts "end around create" 
end 


4.5.3.2 代码 块 (Block) 


before create do 
self.name - login.capitalize if name.blank? 
end 


回调 执行 时 ，self 指 的 是 它 本 身 。 在 注册 的 时 候 ， 我 们 可 能 不 需要 填写 name， 而 要 填写 
login， 所 以 默认 把 name AA login 的 首 字母 大 写 形式 。 


上 面 例 子 也 可 以 改写 成 : 


before create ( |record| 
record.name - record.login.capitalize if record.name.blank? 


} 


4.5.3.3 在 特定 方法 上 使 用 回调 


在 一 些 注册 和 修改 的 逻辑 中 ， 注 册 时 默认 填写 的 数据 ， 在 修改 时 不 做 处 理 ， 所 以 回调 方法 只 
在 create 上 生效 ， 下 面 的 例子 就 是 这 种 情形 : 


before validation(on: :create) do 
self.number - number.gsub(/[^0-9]/, "") 
end 


before validation :normalize name, on: :create 


4.5.3.4 有 条 件 的 回调 
和 校 验 一 样 ， 回 调 也 可 以 增加 放 或 unless 判断 : 


before save :normalize card number, if: :paid with card? 


4.5.3.5 字符 串 形 式 的 回调 


class Topic < ActiveRecord::Base 
before destroy 'self.class.delete all "parent id = #{id}"' 
end 


before destroy BLY 以 接受 符号 定义 的 方法 名 ， 也 可 以 接受 字符 串 。 这 种 方式 要 被 废弃 掉 
T? 
4.5.3.6 回调 的 继承 


一 个 类 集成 自 另 一 个 类 ， 也 会 继承 它 的 回调 ， 比 如 : 


class Topic < ActiveRecord::Base 
before destroy :destroy author 
end 


class Reply « Topic 


before destroy :destroy readers 
end 


在 执行 Reply#destroy 的 时 候 3 两 个 回调 都 会 被 执行 ， 为 了 避 Ep x HP 情 PE TUBE 与 


before_destroy 


class Reply < Topic 
def before destroy() destroy readers end 
end 


但 是 ， 这 是 非常 不 好 的 解决 方案 ! 这 个 代码 只 是 一 个 例子 ， 来 自 这 


回调 虽然 可 以 解决 问题 ， 但 是 它 功 能 太 过 强大 ， 当 项 目 代 码 变 得 复杂 ， 回 调 的 维护 会 造成 很 
大 的 技术 难度 。 建 议 使 用 回调 解决 小 问题 ， 过 多 的 业务 逻辑 应 该 单独 处 理 ， 或 者 使 用 单独 的 
回调 类 e 


4.5.3.6 单独 的 回调 类 


我 们 可 以 用 一 个 类 作为 ”回调 类 ， 使 用 它 的 的 实例 方法 实现 回调 逻辑 : 


class BankAccount « ActiveRecord::Base 
before save EncryptionWrapper.new 
end 


class Encryptionwrapper 
def before save(record) [1] 
record.credit card number - encrypt(record.credit card number) 
end 
end 


[1] 该 方法 仅 能 接受 一 个 参数 ， 为 该 model 实例 © 


还 可 以 使 用 回调 类 的 类 方法 ， 来 定义 回调 逻辑 : 


class PictureFileCallbacks 
def self.after destroy(picture file) 


end 
end 


在 使 用 上 : 


class PictureFile < ActiveRecord::Base 
after destroy PictureFileCallbacks 
end 


使 用 单独 的 回调 类 ， 可 以 方便 我 们 维护 回调 代码 ， 但 是 使 用 起 来 也 需 懂 重 考虑 ， 不 要 增加 后 
期 的 维护 难度 。 


4.5.4 触发 回调 


在 我 们 前 面 讲 解 中 ， 更 新 一 个 记录 时 ，destroy 方法 会 触发 校 验 和 回调 ， 而 delete 方法 不 会 。 
在 这 里 详细 的 列 出 ，ActiveRecord 方法 中 ， 哪 些 会 触发 回调 ， 哪 些 不 会 。 


触发 回调 : 


e create 

e create! 

e decrement! 
e destroy 

e destroy! 

e destroy all 
e increment! 
e save 


e save! 

e save(validate: false) 
e toggle! 

e update attribute 

e update 

e update! 

e valid? 


不 触发 回调 : 


e decrement 

e decrement counter 
e delete 

e delete all 

e increment 

e increment counter 
e toggle 

e touch 

e update column 

e update columns 
e update all 

e update counters 


4.5.5 回调 的 失败 


所 有 的 回调 ， 在 动作 执行 的 过 程 中 ， 是 顺序 触发 的 。 在 before xxx 回调 中 ， 如 果 返 回 
false ? 这 个 回调 过 程 会 被 终止 ? 并 且 触 发 数据 库 事 务 的 rollback ， 以 及 after_rollback 
回调 。 


但 是 ， 对 于 after xx 回调 ， 就 只 能 用 raise 抛 出 异常 的 方式 ， 来 终止 它 。 这 里 抛 出 的 异 
常 必须 是 ActiveRecord::Rollback 。 我 们 修改 下 after create 回调 : 


after_create do 

puts "after create" 

raise ActiveRecord::Rollback 
end 


在 终端 里 : 


» Product.create 
(0.1ms) 
before validation 


begin transaction 


after validation 
before save 
begin around save 
before create 
begin around create 

SQL (0.4ms) 
reated at", "2015-08-03 15:30:20.552783"], 
]] 
end around_create 
after_create 

(8.5ms) rollback transaction 

after rollback 
=> #<Product id: 
3 15:30:20", 


nil, name: nil, price: 


updated_at: "2015-08-03 15:30:20", 


ActiveRecord: :Rollback 


我 们 不 抛 出 这 个 异常 


after_create do 
puts "after create" 
raise StandardError 
end 


虽然 它 也 会 终止 事务 
未 保存 实例 。 


， 没 有 把 保存 数据 ， 但 是 


after rollback 


StandardError: StandardError 


from /PATH/shop/app/models/product.rb:40:in 


4.5.6 after commit 中 的 实例 
quce dion bia DR 


Ze? 个 实例 才 会 被 保存 ， 
i4 其 他 实例 的 关联 。 


4.5.7 回调 计算 库存 


INSERT INTO "products" ("created at", 
["updated at", 


nil, description: 
top: 


终止 了 数据 库 事务 ， 返 回 了 一 个 没有 保存 到 数据 库 中 的 实例 
， 比 如 抛 出 一 个 标准 的 异常 类 : 


它 再 次 抛 出 这 


"updated at") VALUES (?, ?) [["c 


"2015-08-03 15:30:20.552783" 


nil, created at: "2015-08-0 


nil, hot: nil» 


。 如 果 


个 异常 ， 而 不 是 返回 我 们 想 要 的 


"block in <class:Product>' 


它 并 没有 保存 到 数据 库 中 ， 只 有 当 数 据 库 事务 commit 
所 以 我 们 在 after commit 回调 中 读 取 它 数据 库 中 的 id， 并 在 这 


使 用 回调 可 以 适当 精简 逻辑 代码 ， 比 如 我 们 购买 一 个 商品 类 型 时 ， 在 创建 订单 后 ， 应 减少 该 
商品 类 型 的 库存 数量 。 该 减少 数量 的 动作 虽然 属于 整体 逻辑 ， 但 是 和 订单 逻辑 是 分 开 的 ， 而 
它 的 触发 点 正好 在 订单 create 动作 完成 后 ， 所 以 我 们 把 它 放 到 after create Po 


首先 我 们 给 variants 增加 on_hand 属性 ， 表 示 当 前 持 有 的 数量 : 


rails g migration add on hand to variants on hand:integer 


在 orderrb 中 编写 回调 : 


after_create do 
line items.each do |line item| 


line item.variant.decrement!(:on hand, line item.quantity) 
end 


end 


第 五 草 Rails 中 的 控制 器 


课程 概要 : 
本 课程 通过 对 控制 器 的 学 习 ， 了 解 Rails 如 何 通 过 处 理 请 求 和 作出 相应 来 控制 逻辑 的 ， 并 且 完 


成 网 店 中 购物 和 支付 流程 。 


知 AMA] ; 


1. 控制 器 中 的 请 求 和 相应 
2. 控制 器 中 的 方法 


课程 背景 


控制 器 Controller 是 MVC 中 调度 员 的 角色 ， 它 接收 客户 端 发 送 过 来 的 请 求 ， 并 且 通 过 我 们 编 
写 的 代码 作出 相应 ， 实 现 业务 逻辑 的 控制 。 


5.1 控制 器 中 的 请 求 和 相应 
概要 


本 课时 讲解 控制 器 中 如 何 处 理 传 入 的 参数 和 相应 ， 并 且 介 绍 在 请 求 和 相应 的 过 程 中 ， 如 何 处 
理 请 求 参数 ， 使 用 sesson， 设 置 etag 缓存 和 使 用 csrf 确保 数据 来 源 安全 。 


知 TR [LAMA 


e request 

e response 
e params 

e respond to 
e session 

e cookies 

e etag 


e csrf 


正文 


5.1.1 Action Pack 


Action Pack c Rails 种 又 一 个 核心 的 Gem， 它 可 以 处 理 web 请 求 ， 使 用 routes 中 定义 的 规 
则 调用 控制 器 (Controller) 及 方法 (Action) ， 并 且 自 动 判断 请 求 类 型 ， 做 出 对 应 的 相应 。 


Rails 中 的 控制 器 ， 指 的 就 是 处 理 请 求 及 做 出 相应 。 


5.1.2 Request 类 


ActionDispatch::Request 类 是 对 web 请 青 求 的 包 AX 它 有 两 个 常用 的 方法 : 


request.headers["Content-Type"] # => "text/plain" 


headers 包含 了 请 求 的 头 信息 。 


request.parameters 


它 会 返回 请 求 的 参数 ， 不 过 我 们 并 不 直接 使 用 它 ， 而 是 使 用 params 方法 获得 ， 这 在 稍 后 介 


Request 类 的 源 代码 在 这 


5.1.3 Response X 


ActionDispatch::Response 类 代表 了 响应 结果 ， 它 也 有 常用 的 方法 ， 不 过 我 们 更 经 常用 的 是 
Controller 中 的 action 和 回调 。 在 一 些 测试 代码 中 ， 我 们 经 常 使 用 response 实例 。 


比如 ， 我 们 测试 商品 删 除 之 后 ， 会 返 返回 到 | 商品 列表 ， 我 们 的 测 试 代码 是 : 


RSpec.describe ProductsController, type: :controller do 


describe "DELETE #destroy" do 
it "redirects to the products list" do 
product - Product.create! valid attributes 
delete :destroy, {:id => product.to param), valid session 
expect(response).to redirect to(products url) 
end 
end 
end 


Request 和 Response 在 我 们 的 业务 逻辑 代码 中 并 不 不 常用 到 ， 下 面 介绍 的 内 容 ， 是 我 们 在 
编写 控制 器 代码 时 ， 经 常 遇 到 的 。 


5.1.4 strong paramaters 


Controller 是 控制 器 的 概念 ， 所 谓 控制 ， 指 在 网 络 传输 中 ， 接 收 参 数 和 做 出 相应 。Controller 
有 两 种 方式 接收 参数 : GET fe POST。 两 种 方式 均 可 通过 params 读 取 传递 的 内 容 。 


在 Rails3 之 前 的 版 本 中 ， 当 接收 传递 的 参数 ， 用 来 更 新 资源 属性 时 ， 可 以 设 定 Model 的 属性 
白 名 单 ， 非 报名 单 上 的 属性 不 允许 通过 参数 传递 的 方式 修改 ， 比 如 : 


class User < ActiveRecord::Base 
attr accessible :name 
end 


在 Rails4 之 后 ， 这 个 方法 转 为 gem? Ae Rails 4 的 核心 功能 ， 但 将 在 Rails 5 中 重新 回 
到 核心 功能 中 。 现 在 ， 使 用 permit 方法 来 过 滤 参 数 。 使 用 scaffold 创建 的 Controller 默认 
使 用 了 该 方法 : 


class ProductsController < ApplicationController 
def create 
product = Product.new(product params) 


private 
def product params 
params.require(:product).permit(:name, :price, :description) 
end 
end 


permit 可 以 设 定 关联 关系 的 属性 : 


params.require(:product).permit(:name, :price, :description, variants attributes: [:pr 
ice, :size, :id, : destroy]) 


:id 和 : destroy 适用 于 上 一 章 介 绍 的 accepts nested attributes for 方法 。 


5.1.5 respond to 方法 


Controller 响应 请 求 有 多 种 结果 ， 响 应 返回 status Code ， 常 见 的 有 200 (成 功 响 应 ) ， 
302 ( 跳 转 ) ，404 (未 找到 资源 ) ，500 (内 部 错误 ) 。 更 多 响应 Code 参考 3.3 视图 中 的 
AJAX 交互 。 


一 个 controller 的 action 对 应 一 个 请 求 ， 这 样 可 以 保持 我 们 业务 逻辑 代码 清晰 ， 易 维护 。 一 个 
action 可 以 响应 一 个 请 求 的 多 中 类 型 ， 这 在 我 们 第 三 章 里 已 经 有 了 介绍 和 演示 。 


Controller 使 用 respond to 方法 ， 针对 每 一 种 请 求 类 型 ， 做 出 响应 : 


respond to do |format | 
if @product.save 
format.html { redirect to @product, notice: 'Product was successfully created.' } 
format.json { render :show, status: :created, location: product } 
else 
format.html ( render :new j 
format.json ( render json: @product.errors, status: :unprocessable entity } 
end 
format.js 
end 


当 我 们 处 理 多 个 资源 时 ， 每 个 资源 的 create 和 update 等 资源 方法 ， 大 多 都 具备 相同 的 逮 
辑 代码 。 除 了 特定 的 业务 逻辑 ， 他 们 都 会 响应 典型 的 资源 操作 。 Rails 4.2 之 前 提供 了 
respond with 访问 ，4.2 之 后 将 它 转 为 一 个 gem， 我 们 安装 这 个 gem: 


gem "responders" 


并 且 创 建文 件 : 


96 rails g responders:install 
create lib/application responder.rb 
insert config/application.rb 
prepend app/controllers/application controller.rb 
insert app/controllers/application_controller.rb 
create config/locales/responders.en.yml 


默认 ， 它 只 支持 :html， 因 为 我 们 演示 时 ， 又 使 用 到 了 json 和 :js， 还 有 :xml， 我 们 将 这 些 类 
型 添加 上 : 


class ApplicationController < ActionController::Base 
self.responder - ApplicationResponder 
respond to :html, :xml, :json, :js 


我 们 将 刚才 respond to 方法 改 成 respond with ， 精 简 重 复 的 代码 (Dry up your code) 


def create 
@product = Product.create(product params) 
respond with(@product) 

end 


在 6.4118n 中 ， 我 们 讲 118n 文件 做 了 整理 ， 这 里 我 们 把 generator 创建 的 语言 包 ， 按 照 6 
一 节 中 介绍 的 方式 进行 管理 ， 并 且 增 加 中 文 提示 。 如 此 ， 我 们 不 必 为 每 个 资源 创建 、 pasa 
操作 各 自 编写 语 $4; 示 了 。 


5.1.6 session 和 cookies 


从 一 个 请 求 到 另 一 个 请 求 ，Rails 使 用 Session 来 保存 一 些 简单 的 信息 ， 比 如 user id 等 。 同 
时 ， 也 可 以 用 cookies 保存 该 信息 。 


当 Rails 项 目 创建 的 时 候 ， 它 会 有 一 个 默认 的 cookie name， 这 在 


config/initializers/session store.rb 中 : 


Rails.application.config.session store :cookie store, key: ' rails-practice session' 


这 里 ， 我 们 用 cookie store 来 储存 session， 当 我 们 在 项 目 中 保存 session 的 时 候 ， 数 据 会 
保存 在 这 个 cookie 中 。 





Q 日 Elements Network Sources Timeline Profiles | Resources | Audits Console 


b Frames | Name - af Value omain 
web SQL _rails-practice_session WmQyNFliznprd3BpMnpmTUtKS2twWjdYcVFQQU5EWVZEQIlyb.. | Hcalhost 


£4 IndexedDB 
> EB Local Storage 
> EB Session Storage 
v B3 Cookies 


F2 localhost 


BB Application Cache 


#. Rails 2 之 前 ， 可 以 decode 这 个 内 容 ， 查 看 其 中 session VAR: 


require 'rack' 

cookie = "WmQyNFliznprd3..." 

Rack::Session::Cookie::Base64: :Marshal.new.decode(cookie) 

=> ("session id"-»"d3b17...", "user id"-2"123", "_csrf_token"=>"rtkofT..."} 


因为 在 Rails 3 中 已 经 增加 了 secret key base ， 所 以 无 法 直接 decode ART ° 


但 是 ， 如 果 单 独 使 用 一 个 cookie 来 记录 数据 ， 默 认 是 不 经 过 任何 加 密 的 : 


cookies[:name] = "Rails" 


Qa 日 Elements Network Sources Timeline Profiles | Resources | Audits Console 





> Frames | Name a | Value BITE 


H web SQL rails-practice session CUIYNXBORWVDMGZRdWcwam]2ejR5 MVJFUU4vdU9rTzISUDVOdll... | local... | / 
pine local- | 


> EB Local Storage 
> EB Session Storage 
v E3 Cookies 


| Jocalhost 
BB Application Cache 





如 果 这 个 数据 不 想 被 暴露 ， 需 要 单独 加 密 : 


cookies.signed[:name] = "Rails" 
cookies.permanent.signed[:name] - "Rails" [1] 


permanent 会 让 这 个 cookie 有 20 年 的 有 效 时 间 。 
Cookie 的 api 文档 在 这 里 


如 果 我 们 在 Cookie 中 保存 了 过 多 数据 ， 会 超出 cookie 的 大 小 限制 ， 这 时 我 们 可 以 更 改 
session 的 保存 方式 ， 比 如 使 用 redis > memcached 等 。 


Rails.application.config.session store :redis store, servers: ( 
host: "127.0.0.1", 
port: 6379, 
namespace: "store session") 


在 6.2 缓存 中 有 其 他 详细 的 介绍 。 


5.1.7 etag 


Controller 响应 的 时 候 ，header 中 会 包含 etag 属性 ， 根 据 这 个 属性 ， 浏 览 器 会 判断 该 内 容 是 
否 修改 。 


headers['ETag'] = Digest::MD5.hexdigest(body) 


但 对 ced ， 经 常 包含 变动 的 内 容 ， 比 如 登录 后 会 显示 用 户 名 称 ， 未 登录 显 
示 登 录 连 接 。 并 且 ，body 可 能 > md5 时 间 长 。 


我 们 可 以 针对 资源 ， 单 独 增加 etag : 


def show 
fresh when([@product, current user.try(:id)]) 


end 


也 可 以 将 它 精简 : 


class ProductsController « ApplicationController 
etag { current user.try(:id) } 


def show 
fresh when(Qproduct ) 
end 


如 果 我 们 仅 提供 数据 ， 比 如 api， 可 以 去 掉 模板 : 


fresh when Qproduct, template: false 


5.1.8 csrf 


在 Controller 接收 请 求 数据 的 时 候 ， 安 全 机 制 会 处 理 跨 站 请 求 伪 造 (cross-site request 
forgery > Ñr CSRF) 。 在 我 们 的 布局 (layout) 页 面 ， 你 可 能 已 经 看 到 这 样 一 个 辅助 方法 : 


<%= csrf meta tags %> 


打开 页 面 的 源码 ， 我 们 可 以 看 到 : 


«meta name-"csrf-param" content-"authenticity token" /> 
«meta name="csrf-token" content-z"O3Li25wJKObuXKRQRXACzpAWheQIQ4VknCPe3KwNIFKIUuUSbBApxl 
2jVVTd9IcmzR80HLZIOqZpO39aLdNaBAQ--" /> 


当 我 使 用 表单 的 辅助 方法 form for 和 form tag 时 ， 表 单 会 自动 创建 一 个 隐藏 控件 


«input type="hidden" name-"authenticity token" value="GI5YwKDhQA4pM1LRaUlpHugYdL5ygNe3 
Co6TL8PvZDsrRfEA00Ia36+707ZRFqJjP8T2d+j3+0nYcpt4GzZTFYw=="> 


当 我 们 使 用 remote: true 时 ， 这 个 控件 又 消失 了 ， 这 样 是 不 是 不 安全 ? 不，Ujs 在 提交 的 时 
候 ， 为 我 们 自动 补充 上 了 authenticity token 参数 。 

更 多 Rails 安全 问题 ， 可 以 参考 这 里 http://guides.ruby-china.org/security.html ° 

i 


感谢 Rails 4 - Zombie Outlaws， 本 节 3*5 的 内 容 灵 感 来 自 。 


5.2 控制 性 中 的 方法 


概要 


本 课时 讲解 Controller 中 的 回调 ， 权 限 控制 ， 及 如 何 实现 网 店 的 购物 车 和 支付 功能 ， 以 及 使 用 
datatable 查看 订单 数据 。 


回调 
权限 设置 

状态 变更 

支付 

带 分 页 的 数据 列表 
datatable 


oak WN > 


EL 


5.2.1 回调 


和 Model 中 的 回调 一 样 ，Controller 中 也 有 回调 。Rails 4 之 前 ， 它 称 作 过 滤器 ，Filter， 现 在 
一 些 文档 也 在 使 用 filter 字样 。 


回调 它 之 前 的 名 字 是 xxx filter ， 但 是 这 种 称呼 很 是 歧义 ， 于 是 在 Rails 4 中 改 成 了 


xxx action ? 


Controller 中 的 回调 有 三 个 ，before，after，around。 并 且 可 以 通过 :only 和 :except 指定 
在 哪些 方法 上 应 用 该 回调 。 


在 我 们 的 项 目 里 ， 为 了 使 登录 用 户 才 能 访问 ， 我 们 在 application controller.rb 中 已 经 使 用 
了 一 个 前 置 回 调 : 
class ApplicationController < ActionController::Base 
before action :authenticate user! 


end 


因为 其 他 的 Controller 都 继承 自 它 , 所 以 这 个 前 置 回调 会 在 所 有 Controller 中 生效 也 就 是 
说 ， 访 问 所 有 页 面 ， 都 需要 登录 状态 。 


但 是 对 于 首页 ， 展 示 页 等 ， 可 以 公开 访问 的 页 面 ， 我 们 需要 跳 过 这 个 登录 校 验 ，Controller 中 


还 可 以 使 用 skip before action :xxx 跳 过 回调 。 


class ProductsController < ApplicationController 
skip before action :authenticate user!, only: [:index, :show, :top] 
end 


回调 也 可 以 使 用 block 和 单独 的 回调 类 ， 方 法 和 Model 中 一 样 ， 或 者 参考 这 里 。 ( 注 : CR 
在 用 filter 字样 ) 


5.2.2 权限 控制 


Controller 除了 对 请 求 作 出 相应 ， 另 一 个 重要 的 事情 是 做 权限 控制 ， 只 有 拥有 权限 的 用 户 才 可 
以 触发 方法 。 权 限 管 理 有 很 多 gem 可 用 ， 常 用 的 有 cancan > pundit 等 。 


由 于 cancan 已 经 两 年 没有 维护 了 ， 所 以 Ruby 社 区 推出 cancan 的 社区 版 cancancan。 


% rails g cancan:ability 
create app/models/ability.rb 


编辑 abilityrb， 我 们 的 权限 是 : 当 一 个 user (LER) 字段 role 是 admin 时 ， 可 以 管理 所 有 
资源 3 否则 , 只 能 管理 它 自 e 资源 


user ||» User.new £ guest user (not logged in) 
if user.admin? 

can :manage, :all 
else 

can :read, :all [1] 

can :manage, Address, :user id -» user.id [2] 
end 


[1] 非 管理 员 可 读 所 有 
[2] 用 户 管理 自己 的 收 货 地 址 


我 们 给 users 表 添 加 role 字段 : 


rails g migration addRoleToUsers role:string 


在 视图 中 判断 权限 : 


<%= link to "Edit", edit product path(product) if can? :update, product %> 


这 里 有 四 个 动作 可 以 判断 : :read ， :create ， :update ， :destroy ° 
RAE Controller 中 增加 load and authorize resource 回调 ， 这 个 回调 将 自动 加 载 一 个 资 


源 ， 并 且 进 行 权 限 校 验 ， 这 适合 资源 管理 中 的 方法 : 


class ProductsController < ApplicationController 
load and authorize resource 


也 可 以 将 这 个 回调 分 成 两 个 回调 ， 这 样 方便 履 写 其 中 的 方法 : 


class ProductsController < ApplicationController 
load resource 
authorize resource 
更 多 文档 详 见 这 里 。 
也 可 以 不 实用 回调 ， 直 接 在 方法 上 判断 权限 ， 比 如 判断 当前 用 户 是 否 可 以 创建 商品 : 
class ProductsController < ApplicationController 
def create 


authorize! :create, @product 


cancancan 更 多 用 法 ， 详 见 wiki » 


5.2.3 购物 车 
购物 车 有 多 种 设计 思路 ， 有 的 会 把 信息 保存 在 cookie 中 ， 有 的 保存 在 数据 库 中 。 


我 们 将 它 保存 到 数据 库 中 ， 使 用 Cartltem 这 个 Model。 当 向 购物 车 增加 商品 时 ， 我 们 将 商品 
的 商品 类 型 (Variant) 以 及 数量 保存 到 购物 车 中 。 如 果 再 次 购买 ， 会 增加 该 商品 类 型 的 数 


a 


wo 


我 们 将 订单 的 创建 过 程 分 为 三 步 ， 第 一 步 : 确认 购物 车 ， 第 二 步 : 填写 收 货 地 址 ， 第 三 部 : 
形成 订单 ， 第 四 部 : 支付 ， 第 五 步 : 支付 成 功 后 通知 订单 。 


为 了 方便 管理 购物 和 支付 流程 3 我 把 这 个 逻辑 单独 的 放置 在 checkout controller.rb ° 


当 我 们 计算 购物 车 和 商品 类 型 价格 的 时 候 ， 经 常 的 出 现 line item.variant.price ， 这 种 查询 
可 以 通过 Model 中 的 delegate 进行 改进 : 


class LineItem < ActiveRecord::Base 


delegate :price, to: :variant, prefix: true 


这 样 ， 刚 才 的 查询 可 以 改 为 line item.variant price ° delegate 方法 的 api 在 这 里 。 
但 是 ， 这 种 方法 会 造成 过 多 的 查询 ， 所 以 在 确定 使 用 这 种 方法 后 ， 我 们 可 以 使 用 has many 


中 的 includes 选项 : 


class Order < ActiveRecord::Base 
has many :line items, -> ( includes :variant } 
end 


当 我 们 再 次 查询 line items 时 ， 会 自动 的 检索 关联 的 variant > AF RA sql 查询 。 
我 们 编写 代码 的 时 候 ， 有 一 些 代码 可 能 需要 优化 ， 有 一 些 功 能 还 待 完 成 ， 这 时 可 以 在 代码 中 
增加 特殊 的 注释 : 


def checkout 
# OPTIMIZE 
# TODO 
# FIXME 


使 用 rake 命令 可 以 查看 代码 中 的 注解 


rake notes:optimize/fixme/todo 


关注 购物 车 的 其 他 环节 ， 我 们 可 以 查看 代码 演示 ， 它 所 使 用 的 方法 ， 我 们 之 前 已 经 介绍 过 
了 。 


5.2.4 支付 


订单 创建 时 ， 它 的 payment state 为 confirm ， 当 完 成 支付 后 ， 它 的 状态 改 为 paid ? 这 里 
我 们 使 用 支付 宝来 支付 订单 。 


我 们 需要 安装 支付 宝 的 gem e 
并 且 增 加 初始 配置 文件 config/initializers/alipay.rb ， 这 里 需要 填写 从 支付 宝 商 家 服务 申 


请 的 PID 和 KEY。 


Alipay.pid = ' 申 请 的 PID' 
Alipay.key = ' 申 请 的 KEY' 


支付 宝 常 用 实时 到 账 和 担保 交易 ， 如 果 开 通 了 支付 宝 快捷 登陆 ， 在 使 用 实时 到 账 时 ， 可 以 扫 
描 二 维 码 支付 。 


支付 成 功 后 ， 通 常设 定 为 跳 转 回 订单 详细 页 面 ， 支 付 宝 会 通过 接口 自动 通知 notify 方法 ， 
我 们 应 该 在 该 方法 中 更 新 订单 状态 ， 并 且 通 知 支付 宝 是 否 成 功 ， 只 需 render text: 


"success" 或 render text: "fail" ° 


这 里 有 一 份 非常 详尽 的 支付 宝 集成 方案 ， 欢 迎 参 考 。 


5.2.5 带 分 页 的 数据 列表 


进入 到 “我 的 订单 ”页面 ， 会 有 多 条 订单 记录 ， 这 里 需要 对 订单 进行 分 页 。 常 用 的 分 页 gem 是 
will_paginate。 因 为 我 们 在 使 用 bootstrap， 所 以 需要 安装 will paginate-bootstrap。 


分 页 的 代码 非常 简单 : 
class OrdersController < ApplicationController 
def index 


@orders = Order.paginate(:page => params[:page], :per page -5 20) 


页 面 上 : 


«div class="well"> 
<%= page entries info Qorders %> 
«/div» 
<%= will paginate Qorders, renderer: BootstrapPagination::Rails 96» 


为 了 让 page entries info 方法 和 分 页 按钮 显示 中 文 ， 我 们 增加 一 个 新 的 语言 


config/locales/will paginate/zh-CN.yml 


除了 will paginate > 24 kaminari， 以 及 datatable 


5.2.6 datatable 


datatable 是 传统 分 页 方法 的 一 个 极 好 的 替代 ， 当 数据 量 较 多 ， 且 需要 ajax 加 载 数据 时 ， 可 以 
使 用 server 3% datatable 实现 ， 具 体 请 参考 示例 列表 。 


当 我 们 的 订单 数量 巨大 的 时 候 ， 我 们 需要 使 用 datatable 的 server-side， 来 减轻 分 页 加 载 时 的 
压力 。 这 里 有 一 个 演示 ， 供 大 家 参考 。 


控制 器 中 的 逻辑 


164 


第 六 章 Rails 的 配置 及 部 署 


N v $ 

课程 概要 : 

本 课程 讲解 Rails 中 Assets 管理 ， 异 步 任 务 及 邮件 发 送 ， 缓 存 ， 多 语言 包 ， 以 及 如 何在 服务 
器 中 部 署 。 

知识 ANNN : 

1. Assets 管理 

2. 缓存 及 缓存 服务 

3. 异步 任务 及 邮件 发 送 
4. |18n 

5， 生 产 环境 部 署 

6. 常用 Gem 排行 


课程 背景 


在 Rails 上 线 前 ， 需 要 做 好 一 些 配置 工作 ， 并 且 实 现 常见 的 商用 功能 ， 如 邮件 发 送 ， 语 言 包 ， 
快捷 部 署 等 ， 同 时 要 了 解 如 何在 linux 服务 器 上 部 署 Rails 程序 。 


6.1 Assets 管理 


概要 : 


本 课时 讲解 如 何 管理 Rails 中 的 css) js 等 静态 文件 。 


án qu [LAMA 。 


1. assets 编译 
2. 静态 文件 
3. cdn 


ET 
当 第 一 次 用 production 247 Rails 时 ( rails s -e production ) ， 很 可 能 提示 找 不 到 资源 : 


Console | Search Emulation Rendering 


© Y stop frames v [Preserve log 














Q Failed to load resource: the server responded with a status of 404 (Not Found) http://localhost:3000/javascripts/products. js 
Q Failed to load resource: the server responded with a status of 404 (Not Found) http://localhost:3000/javascripts/application.js 
@ Failed to load resource: the server responded with a status of 404 (Not Found) http: //localhost:3000/images/logo.png 
@ Failed to load resource: the server responded with a status of 404 (Not Found) http://localhost:3000/stylesheets/application.css 
Q Uncaught ReferenceError: $ is not defined localhost/:217 
Q Failed to load resource: the server responded with a status of 404 (Not Found) http: //localhost:3000/images/favicon.ico 
@ Failed to load resource: the server responded with a status of 404 (Not Found) http://localhost:3000/stylesheets/application.css 





因为 我 们 还 没有 编译 这 些 静 态 资 源 ， 说 编译 是 因为 Rails 默认 使 用 了 sprockets-rails 这 个 
gem 来 管理 Assets 文件 。 


6.1.1 Assets 管理 


Rails 的 Assets 包括 已 经 看 到 的 stylesheets > javascript # images， 我 们 还 可 以 增加 
fonts。 sprockets-rails 提供 了 几 个 管理 这 些 资源 的 Rake 任务 。 其 中 最 常用 的 是 rake 


assets:precompile ° 它 的 含义 是 ， 编译 所 有 在 config.assets.precompile 中 定义 的 资源 。 


Rails 默认 加 载 app/assets , lib/assets fe vendor/assets 中 的 文件 到 precompile 路 径 
中 。 我 们 引用 这 些 资源 文件 的 文件 ， 叫 manifest file ， 可 以 理解 为 白 名 单 。 这 里 有 两 个 引 
用 命令 : 


app/assets/styleshetts/application.css 


*- require self 
*- require tree . 


这 是 一 种 简单 的 引用 ， require self 会 先 加 载 自 身 定 义 的 内 容 ， 然 后 加 载 其 他 所 有 目录 下 的 
文件 ， 也 就 是 require_tree .中 可 以 找到 的 文件 。 但 是 ， 我 们 引用 的 是 bootstrap 文件 ， 它 
有 变量 文件 ， 而 require tree 命令 不 一 定 会 优先 编译 这 个 变量 文件 ， 所 以 会 出 现 : 


Less::ParseError: variable Qnavbar-default-bg is undefined 


这 样 的 错误 。 而 且 当 项 目的 assets 文件 越 来 越 多 ， 引 用 的 各 种 sass 文件 和 less 文件 存在 互 
相 顽 盖 的 时 候 ， require tree 会 让 这 种 引用 杂乱 ， 且 文件 及 肿 庞 大 。 


这 时 我 们 可 以 明确 引用 的 文件 ， 比 如 : 


*= require self [1] 

*= require simplex/loader 

*- require simplex/bootswatch 

*= require bootstrap and overrides 


如 果 我 们 在 该 文件 里 不 写 其 他 css， 可 以 把 [ 们 去掉。 


如 果 我 们 在 application.css 中 写 了 一 些 css， 又 require 了 其 他 文件 ， 如 果 不 使 用 
require self ， 编 译文 件 中 我 们 写 的 不 是 出 现在 顶部 而 可 能 出 现在 底部 。 require self 
会 保持 编译 结果 顺序 和 引用 顺序 相 o 


这 样 运行 该 命令 ， 会 把 这 些 资源 编译 到 public/assets 目录 下 。 那 么 ， 其 他 没有 没有 在 此 被 
引入 ， 而 也 要 使 用 的 文件 ， 该 如 何 被 编译 呢 ? 


Rails 4 将 assets 的 配置 文件 单独 放置 在 config/initializers/assets.rb 中 : 


Rails.application.config.assets.precompile += %w( products.js ) 
Rails.application.config.assets.precompile += %w( cerulean.js cerulean.css ) 


products.js 文件 中 定义 了 两 个 方法 ， 它 只 在 一 个 页 面 上 使 用 ， 就 没 必 要 编译 到 整体 文件 
里 ， 只 要 在 需要 它 的 页 面 引用 即 可 : 


app/views/products/index.html.erb 


<%= javascript include tag "products" 96» 


总 结 一 下 ， 使 用 白 名 单 加 载 的 assets 文件 ， 可 以 认为 是 “编译 + 合并 ” 模式 ， 全 局 都 使 
用 的 css 和 je o 单独 写 入 config.assets.precompile 的 文件 是 局 部 引用 。 


6.1.2 使 用 字体 


为 我 们 把 bootstrap 中 定义 的 变量 放 到 了 assets 下 ， 所 以 需要 单独 引用 bootstrap 3 中 使 用 
的 Glyphicons 字体 : 


@font-face { 
font-family: 'Glyphicons Halflings', 
src: font-url('glyphicons-halflings-regular.eot'); 
src: font-url('glyphicons-halflings-regular.eot?Ziefix') format('embedded-opentype' 
), 
font-url('glyphicons-halflings-regular.woff') format('woff'), 
font-url('glyphicons-halflings-regular.ttf') format('truetype'), 
font-url('glyphicons-halflings-regular.svgzZglyphicons halflingsregular') format( 
'Svg'); 
} 


如 果 不 做 任何 修改 ， 则 不 必 再 次 引用 ，gem 会 自动 把 它们 包含 进来 。 


如 果 使 用 新 的 字体 或 图 标 ， 需 要 把 新 字体 文件 放 到 assets/fonts 中 ， 然 后 定义 : 


Qfont-face { 

font-family: 'Trajan Pro'; 

font-style: normal; 

src: font-url('trajan pro/trajan pro.woff'); 

src: font-url('trajan pro/trajan pro.eot?#iefix') format('embedded-opentype'), 
font-url('trajan pro/trajan pro.woff') format('woff'), 
font-url('trajan pro/trajan pro.ttf') format('truetype'), 
font-url('trajan pro/trajan pro.svg#Regular') format('svg'); 

font-weight: normal; 

font-style: normal; 


这 是 一 款 购 买 的 商业 字体 ， 引 用 的 时 候 : 


«font face="Trajan Pro"><%= product.name %></font> 


6.1.3 CDN 


如 果 我 们 不 引用 编译 的 文件 ， 直 接 使 用 application.js 和 application.css 不 可 以 么 ?这 在 
开发 环境 下 自然 没 问 题 ， 但 是 在 产品 环境 下 ， 尤 其 遇 到 缓存 和 cdn 时 ， 会 造成 加 载 缓慢 ， 无 
法 及 时 清理 过 期 时 间 的 问题 。 


首先 ，Rails 默认 启用 了 assets 的 digest 选项 ， 这 样 编译 文件 的 时 候 ， 会 带 有 md5 字符 ， 形 
象 的 叫做 we 。 当 我 们 修改 内 容 之 后 ， 其 该 值 会 变动 ， 生 成 新 的 文件 名 ， 并 且 编 译 最 新 的 文 
件 。 如 果 我 们 用 nginx 来 作为 web server， 可 以 针对 这 种 文件 设置 缓存 ， 如 果 使 用 外 部 
cdn， 可 以 把 最 新 的 文件 发 布 到 cdn 中 ( 回 源 模式 会 自动 从 服务 器 读 取 ， 无 需 发 布 ) 。 


在 nginx 的 配置 : 


location ~ ^/assets/ { 
expires 1y; 
add header Cache-Control public; 


add header ETag ""; 
break; 


在 产品 环境 使 用 cdn 时 ， 需 要 更 改 配置 : 


config.action controller.asset host = "http://cdn.domain.com" 


当 使 用 xxx. url 这 个 routes helper 时 ， 会 自动 带 上 cdn 的 地 址 。 
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6.2 45 


概要 : 


本 课时 讲解 Rails 中 如 何 使 用 缓存 。 


GRE: 


1. RR 
2. redis 


3. memcached 
ET 


6.2.1 Rails #4 


Rails 提供 了 三 种 方式 的 缓存 ， 页 面 缓存 ， 方 法 缓存 和 片段 缓存 ， 在 Rails 4 之 前 的 版 本 里 ， 
它 包含 在 Rails 中 ， 但 是 从 Ax 开始 ， 三 种 缓存 中 的 两 种 转 为 gem 形式 ， 只 有 片段 缓存 保留 
在 Rails 默认 F ° 


在 开发 环境 下 ， 缓 存 是 关闭 的 ， 如 果 要 测试 它 ， 需 要 更 改 配置 : 


config.action controller.perform caching = true 
在 产品 环境 下 ， 它 默认 是 true。 


6.2.2 页 面 缓存 ，Page Cache 
Rails 4.x 将 页 面 缓存 转 为 gem， 使 用 的 时 候 需要 加 入 到 gemfile 中 。 


我 们 设置 一 下 缓存 路 径 ， 在 config/environments/development.rb 


config.action controller.page cache directory = "#{Rails.root.to_s}/public" 


页 面 缕 存 是 将 整个 页 面 ， 生 成 一 份 静态 的 html 页 面 ， 这 个 页 面 会 保存 在 刚才 设置 的 目录 中 。 
Rails 在 显示 该 地 址 的 时 候 ， 会 优先 查找 public 是 否 有 同名 的 html 文件 优先 显示 。 


我 们 把 show 方法 加 入 到 页 面 缓存 中 : 


class ProductsController < ApplicationController 


caches page :show 


当 第 一 次 访问 时 ， 会 创建 该 缓存 文件 : 


Write page /path/to/project/public/products/3.html (9.5ms) 


再 次 访问 时 ， 便 直接 读 取 该 文件 ， 而 不 再 执行 show 方法 了 。 


这 样 做 的 好 处 是 ， 可 以 把 一 些 经 常 访问 的 页 面 作为 页 面 缓存 。 缺 点 是 ， 这 种 页 面 不 能 有 太 多 
用 户 的 个 人 信息 ， 因 为 这 个 页 面 对 所 有 人 访问 都 是 相同 的 内 容 。 如 果 必 须 考虑 个 人 信息 ， 可 
以 改 为 js 形式 ， 或 者 使 用 方法 缓存 (Action Cache) 。 

当 这 个 缓存 页 面 内 容 更 改 时 ， 可 以 删 掉 该 文件 ， 再 次 访问 时 会 自动 创建 。 也 可 以 在 update 


内 加 入 过 期 的 命令 : 


def update 
respond to do |format | 
if @product.update(product params) 
expire page action: 'show', id: Qproduct.id 
else 
end 


end 
end 


更 新 资料 后 会 自动 过 期 该 文件 。 


Expire page /path/to/project/public/products/3.html (1.0ms) 


6.2.3 方法 缓存 ，Action Cache 


方法 缓存 和 页 面 缓存 的 区 别 是 : 它 会 执行 对 应 的 action 中 的 代码 。 页 面 缓存 直接 读 取 缓存 文 
件 ， 不 执行 action 中 的 代码 。 


页 DAE gem 在 这 里 。 


我 们 给 方法 增加 方法 缓存 : 


class ProductsController « ApplicationController 


caches action :index, layout: false 


访问 该 页 面 ， 会 创建 一 个 片段 缓存 (fragment cache) 文件 : 


Write fragment views/localhost:3000/products (5.9ms) 


该 片段 缓存 为 当前 整个 页 面 ， 我 们 增加 layout: false 参数 ， 这 样 ， 片 段 缓存 只 包含 该 
action 对 应 的 模板 内 容 ， 而 不 包含 layout。 我 们 设计 的 代码 ， 将 用 户 信息 放置 在 layout 中 ， 
登录 后 会 显示 用 户 名 。 所 以 layout 是 不 应 该 放 到 缓存 中 的 。 


但 是 ， 因 为 我 们 给 index 方法 增加 了 搜索 功能 ， 而 该 方法 已 经 加 入 到 了 缓存 中 ， 所 以 ， 搜 索 
是 还 是 显示 的 缓存 内 容 。 这 里 可 以 做 调整 ， 要 么 将 搜索 放 到 专用 的 非 缓存 方法 中 ， 要 人 么 搜索 
二 过 时 该 缓存 。 


m 


6.2.4 ^ KH > Fragment Cache 
片段 缓存 ， 是 Rails 黑 认 使 用 的 缓存 方式 ， 它 指 的 是 视图 (view) 中 ， 缓 存 局 部 内 容 : 


<% Cache do %> 


X. 
DR: 


<% Catalog.all.each do |catalog| %> 
<%= link_to catalog.name, catalog %> 
<% end %> 
<% end %> 
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我 们 可 以 给 cache 方法 增加 一 些 参 数 : 
<% cache(action: 'new', action suffix: 'all products') do %> 
它 产生 的 缓存 key 是 


Write fragment views/localhost:3000/products/new?action suffix-all products/02c540e3ab 
26f72d5e9273d5824c204e (60.0ms) 


也 可 以 直接 命名 缓存 key: 


<% cache( "all products" ) do %> 


它 产 生 的 缓存 key 是 : 


Write fragment views/all products/cc926a692262d0e538f07d5dd5d54942 (15.1ms) 


或 者 直接 缓存 一 个 实例 : 


<% cache @product do %> 


它 产 生 的 缓存 key 是 : 


Write fragment views/products/3-20150620164035711340000/b0699b1b8be94ebdibfcfe74a21571 
f8 (21.5ms) 


可 见 ， 缓 存 是 产生 一 个 key: value 结构 的 数据 。 key 来 自 于 实例 的 cache key 方法 : 


p = Product.last 

p.cache key 

-» "products/3-20150620164035711340000" 
p.updated at - nil 

p.cache key 

=> "products/3" 


该 方法 会 读 取 updated at 字段 值 ， 这样， 每 当 该 实例 更 改 的 时 候 ， 会 自动 更 新 updated at 
字段 ， 相 当 于 自动 更 新 了 缓存 。 


我 们 可 以 使 用 


expire fragment(action: 'new', action suffix: 'all products') 
expire fragment("all products") 


过 期 这 些 片 段 缓存 


6.2.5 缓存 服务 


缓存 产生 的 是 key: value 结构 的 数据 ， 所 以 我 们 可 以 使 用 支持 该 解构 的 数据 库 来 保存 缓 
存 。 在 config/environments/production.rb 中 有 cache store 的 选项 : 


# Use a different cache store in production. 
config.cache store - :mem cache store 


这 里 有 四 个 选项 可 以 使 用 : :memory. store, :file store, :mem cache store, :null store ° # 
手册 里 还 介绍 了 JRuby 的 Ehcache ° 


6.2.5.1 :memory store 


缓存 和 Ruby 进程 使 用 共同 的 内 存 ， 默 认 大 小 为 32M， 如 果 超出 这 个 范围 ， 会 移 除 掉 旧 的 记 
录 。 我 们 可 以 更 改 这 个 限制 : 


config.cache store = :memory store, { size: 64.megabytes } 


Ww 


多 个 Rails 应 用 不 会 共享 该 缓存 。 它 不 适合 大 型 的 部 署 ， 适 合 小 型 的 ， 低 访问 量 的 应 用 。 
6.2.5.2 :file store 


config.cache store - :file store, "/path/to/cache/directory" 


缓存 利用 文件 系统 来 存放 缓存 文件 ， 虽 然 可 以 在 多 个 应 用 间 共 享 缓存 ， 但 是 不 建议 在 产品 环 
境 下 使 用 。 这 种 方式 会 不 断 的 增加 硬盘 使 用 ， 直 到 手动 清空 所 有 缓存 。 


Rails 默认 使 用 这 种 方式 。 


6.2.5.3 :mem cache store 


这 种 方式 使 用 Memcached Ae 端 缓存 服务 ， 它 提供 了 高 性 能 的 、 集 中 式 的 缓存 服务 ， 可 
以 在 多 个 应 用 间 共 享 缓存 ， 这 是 一 种 适合 中 大 型 商业 应 用 的 选择 。 


config.cache store = :mem cache store, "cache-1.example.com", "cache-2.example.com" 


使 用 Memcached € €x X dalli > 操作 时 : 


Rails.cache.read('key') 
Rails.cache.write('key', value) 
Rails.cache.fetch('key') { value } 


6.2.5.4 :null store 


这 是 一 种 适合 开发 和 测试 环境 的 配置 ， 它 不 会 储存 任何 东西 ， 但 是 可 以 正常 调试 Rails.cache 
中 的 方法 。 


config.cache store = :null store 


6.2.5.5 自 定 义 缓存 服务 


Redis 作为 一 个 高 性 能 的 内 存 型 数据 库 ， 也 可 以 作为 缓存 服务 。 我 们 先 安装 redis 的 gem: 


gem 'redis-rails' 
gem "hiredis" 


增加 配置 : 


config.cache store = :redis store, ( 
host: 127.0.0.1, 
port: 6379, 
password: 123456, 
db: 1, 
namespace: "cache" } 


现在 ， 越 来 越 多 的 Rails 项 目 和 redis 配合 使 用 ， 比 如 下 一 节 要 介绍 的 异步 服务 ， 还 有 大 量 非 
结构 化 的 数据 ， 也 可 以 储存 在 redis 中 。 比 如 站 内 短信 息 ， 好 友 动 态 ， 或 者 好 友 列 表 ， 都 可 以 
通过 redis 的 命令 快速 实现 ， 较 之 关系 型 数据 库 拥 有 更 快 的 读 写 速度 ， 且 更 适合 储存 非 结 构 化 
数据 。 


非 结构 化 数据 库 是 指 其 字段 长 度 可 变 ， 并 且 每 个 字段 的 记录 又 可 以 由 可 重复 或 不 可 重复 
的 子 字 段 构成 的 数据 库 ， 用 它 不 仅 可 以 处 理 结构 化 数据 (如 数字 、 符 号 等 信息 ) MAL 
适合 处 理 非 结 构 化 数据 【全 文 文本 、 图 象 、 声 音 、 影 视 、 超 媒体 等 信息 ) 。 来 自 百度 百 
科 


6.2.6 缓存 的 读 取 和 写 入 


我 们 可 以 在 Rails 项 目 内 部 ， 使 用 Rails.cache.fetch 来 读 取 缓 存 ， 如 果 不 存在 ， 将 返回 
nil， 如 果 传 入 block， 会 将 block 中 的 结果 写 入 缓存 ， 并 将 其 返回 。 比 如 : 


class Product < ActiveRecord::Base 
def competing price 
Rails.cache.fetch( '#(cache key)/competing price", expires in: 12.hours) do 
Competitor::API.find price(id) 
end 
end 
end 


在 fetch 中 可 以 设置 过 期 时 间 。 


更 多 API 信息 可 以 查看 这 里 。 


6.3 异步 任务 及 邮件 发 送 


概要 : 


本 课时 讲解 如 何 使 用 sidekiq 实现 异步 任务 ， 以 及 如 何 使 用 ActionMailer 发 送 邮 件 。 


4n qu ANN ; 


1. ActiveJob 
2. sidekiq 
3. ActionMailer 


正文 


6.3.1 ActiveJob 


务 ， 比 如 邮件 发 送 ， 报 表 计算 ， 用 户 动态 等 等 。 


这 些 任务 具备 一 些 特点 : 


e 执行 时 间 长 ， 比 如 为 所 有 关注 我 的 用 户 创建 好 友 动 态 。 

e 可 以 和 前 段 操 作 分 开 执 行 ， 比 如 用 户 注 册 后 ， 直 接 进 入 界面 ， 而 后 端 任务 在 稍 后 把 欢迎 
邮件 发 出 。 

e 调用 其 他 应 用 的 api 


异步 任务 可 以 解决 这 些 问 题 ， 但 是 三 种 常用 的 异步 任务 有 各 自 的 方法 调用 ，Rails 4 中 使 用 
ActiveJob 来 编写 统一 的 操作 代码 ， 这 样 即便 后 端 服 务 更 换 ， 也 不 用 更 改 业 务 逻 辑 代 码 了 。 
6.3.2 Sidekiq 


Sidekiq 使 用 redis 储存 任务 ， 并 且 一 个 进程 可 以 等 于 20 个 Resque 或 DelayedJob 进程 ( 官 
网 上 的 说 法 ) o 


redis 的 安装 非常 简单 ， 下 载 安 装 包 ， 进 入 src 目录 : 


redis-server 


这 样 一 个 命令 就 可 以 启动 redis 服务 了 。 在 生产 环境 下 ， 可 以 针对 文件 位 置 等 配置 ， 可 以 增加 
一 个 redis.conf 文件 ， 启 动 时 选择 : 


redis-server .conf/redis.conf 


这 里 我 做 了 两 个 修改 : 


dir ./db/redis/ [1] 
logfile ./log/redis.log [2] 
# requirepass foobar 


[1] 在 我 们 的 db 下 建立 redis H x > HH redis 数据 库 文件 [2] redis 日 志 放 入 项 目 日 志 目 录 中 
[3] 我 们 在 开发 环境 下 去 掉 密 码 校 验 


安装 sidekiq 需要 两 个 gem : 


gem 'sidekiq' 
gem 'sinatra', :require -» nil 


通常 我 们 需要 sidekiq 的 管理 界面 ， 来 查看 当前 的 任务 队列 情况 ，sinatra 可 以 单独 启动 这 个 
管理 服务 ， 我 们 修改 一 下 routes : 


config/routes.rb 


Rails.application.routes.draw do 
require 'sidekiq/web' 
mount Sidekiq::Web => '/sidekiq' 


我 们 再 增加 一 个 sidekiq 的 配置 文件 config/sidekiq.yml ， 然 后 运行 它 : 


sidekiq -C config/sidekiq.yml 


sss sss ss 
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这 样 便 启 动 了 sidekiq 服务 ， 我 们 用 它 来 完成 异步 任务 。 在 用 Rails 使 用 sidekiq 前 ， 需 要 在 
config/application.rb 声明 一 下 : 


config.active job.queue adapter = :sidekiq 


6.3.3 异步 任务 ，Job 
我 们 用 generate 来 创建 一 个 任务 类 : 


rails generate job order create 


OrderCreateJob 用 来 处 理 订 单 创 建 时 ， 需 要 额外 完成 的 一 些 操 作 ， 比 如 ， 向 这 个 订单 的 用 户 
发 送 一 封 “订单 已 确认 ”的 邮件 。 我 们 使 用 after create 这 个 回调 ， 来 触发 这 个 异步 任务 。 
class Order < ActiveRecord::Base 
after create :send create email 
def send create email 


OrderCreateJob.perform later(self) 
end 


class OrderCreateJob « ActiveJob::Base 
queue as :default 


def perform(order) 


end 
end 


6.3.4 使 用 ActionMailer 发 送 邮 件 


ActionMailer 是 一 个 邮件 发 送 gem， 它 使 用 了 ActionController 类 和 Mail 发 送 邮 件 ， 邮 件 可 
以 使 用 视图 文件 ， 也 可 以 是 txt 邮件 。 它 也 可 以 接收 邮件 ， 具 体 可 参考 手册 或 文档 。 


我 们 来 创建 一 个 处 理 订 单 邮 件 发 送 的 控制 器 : 


rails generate mailer OrderMailer 
create app/mailers/order mailer.rb 
create app/mailers/application mailer.rb 
invoke erb 


create app/views/order mailer 

create app/views/layouts/mailer.text.erb 

create app/views/layouts/mailer.html.erb 

invoke rspec 

create spec/mailers/order mailer spec.rb 

create spec/mailers/previews/order mailer preview.rb 


我 们 为 app/mailers/order mailer.rb 增加 一 个 发 送 方法 : 


class OrderMailer < ApplicationMailer 


def confirm email(order) 
Quser - order.user 
@order = order 
mail(to: Quser.email, subject: "您 的 订单 #{@order.number} 已 经 确认 ") 
end 
end 


ActionMailer 为 我 们 创建 了 邮件 模板 和 html ` text 两 种 格式 的 邮件 ， 我 们 分 别 制作 相同 的 内 
容 ， 具 体 请 参照 第 六 章 代 码 。 如 果 同 时 存在 html 和 text 视图 ，ActionMailer 会 采用 Multipart 
形式 将 他 们 发 送出 去 。 

入 终端 来 测试 邮件 : 

order = Order.last 

OrderMailer.confirm email(o).deliver later 

Enqueued ActionMailer::DeliveryJob (Job ID: ...) to Sidekiq(mailers) with arguments: 


deliver later 是 将 邮件 发 送 任务 队列 ^ deliver now 是 将 邮 件 立 
于 ，deliver_later 不 会 阻塞 当前 进程 ， 比 如 我 们 页 面 中 会 立刻 进入 
deliver_now 会 等 待 邮 件 发 送 完 成 ， 才 会 进行 下 一 步 


m 


更 ActionMailer 的 介绍 请 查看 Action Mailer Basics ° 


回 到 ordercreateJob ， 我 们 把 邮件 发 送 加 入 到 perform 方法 中 


刻 发 送 。 区 别 在 
下 面 ， 而 


class OrderCreateJob « ActiveJob::Base 
queue as :default 


def perform(order) 
OrderMailer.confirm email(order).deliver now 


end 
end 


因为 我 们 已 经 使 用 异步 任务 ， 所 以 直接 使 用 deliver now 发 送 邮件 了 。 
更 多 ActionMailer 的 配置 ， 在 这 里 有 详细 的 介绍 。 


sidekiq 可 以 完成 其 他 异步 的 业务 逻辑 ， 比 如 确认 订单 后 的 积分 计算 ， 向 关注 我 的 好 友 发 送 动 
态 等 。 因 为 我 们 在 routes 中 增加 了 sidekiq 的 管理 界面 地 址 ， 所 以 访问 
http://localhost:3000/sidekiq 可 以 查看 当前 任务 执行 情况 。 


6.4 118n 


概要 : 


本 课时 讲解 如 何 设置 和 使 用 I18n 语言 


1. i18n 
2. helper 


正文 
在 [4.4.5 使 用 中 文 的 校 验 信息 ] 一 节 中 ， 我 们 简单 的 应 用 了 118n， 这 里 我 们 详细 的 扩展 一 下 。 


6.4.1 118n 


因为 Internationalization 的 1 和 N 之 间 有 18 个 字母 ， 所 以 它 简称 118n。Rails 通过 118n 为 项 
目 提 供 多 语言 包 支 持 ， 这 也 要 求 我 们 在 开发 过 程 中 ， 按 照 118n 的 方式 处 理 显 示 文 字 。 


Rails 默认 使 用 一 个 单一 的 |18n 文件 ， 它 在 config/locales/en.yml ， 这 对 于 中 型 以 上 ， 以 及 
使 用 多 个 Gem 的 应 用 是 不 足 的 ， 我 们 将 整个 文件 夹 下 的 所 有 内 容 ， 都 加 在 到 i18n 的 路 径 
中 : 


config/application.rb 


config.i18n.load path += Dir[Rails.root.join('config', 'locales', '**/*.{rb,yml}').to_ 
s] 


这 样 做 的 好 处 是 ， 我 们 可 以 把 一 些 gem sus 包 ， 放 到 我 们 自己 项 目 中 维护 。 比 如 一 些 gem 
的 zh-CN 语言 包 缺 失 ， 或 者 翻译 不 准确 的 语言 


然后 设 定 我 们 默认 的 语言 


config.ii8n.default locale = :"zh-CN" 


6.4.2 显示 语言 


6.4.2.1 t #7 | 


I18n 有 两 个 常用 的 显示 方法 : 


使 用 方法 含义 例子 
I18n.translate 118n.t 显示 语言 118n.t "name" 
TETTE 18n. 按照 语言 包 定 义 显 示 Date 和 118n.1 

d 5 Time Time.zone.now 
I18n.t 有 三 种 使 用 方法 ， 查 找 语 言 包 : 
二 应 语言 包 结 
查找 方法 ~ g 含义 
zh-CN: ET 5 、 
" " 点 始 查 
118n.t("name") A WEE 从 根 节 点 开始 查找 
zh-CN: 
Users: : 、 
" : ; 根据 视图 路 径 查 找 : 
ae Show views/users/show.html.erb 
name: 
"姓名 " 
zh-CN: 
" " : Users: 
qu dE show: 指定 从 哪个 节点 开始 查找 
à name: 
"姓名 " 


118n.| 会 按照 语言 包 中 定义 的 时 间 格 式 来 显示 ， 为 了 方便 编辑 ， 我 将 它 放 到 了 
config/locales/defaults/zh-CN.yml T ， 它 来 自 这 里 。 


6.4.2.2 使 用 变量 


我 们 在 语言 包 中 可 以 定义 变量 : 


zh-CN: 
hello: "4845, %{name}" 


显示 时 ， 传 入 该 变量 : 


I18n.t("hello", name: "Ruby") 


6.4.2.3 使 用 复数 


在 我 们 的 语言 里 ， 你 和 你 们 是 不 一 样 的 含义 ， 而 英语 里 都 是 you ， 在 语 


单 复数 : 


zh-CN: 
hello: 
one: "你 好 " 
other: "你 们 好 " 


调用 时 : 


I18n.t("hello", count: 1) 
=> "Rap" 

I18n.t( "hello", count: 2) 
=> "ARSE" 


6.4.2.4 使 用 HTML 


-= 


a 


包 里 可 以 定义 


如 果 key 带 有 _html， 或 者 定义 了 html 的 key， 会 认为 它 是 安全 的 HTML ， 否 则 输出 将 被 


escape: 


config/locales/en.yml 


en: 
welcome: «b»welcome!«c/b» 
hello html: <b>hello!</b> 
title: 
html: <b>title!</b> 


app/views/home/index.html.erb 


<%= t('welcome') 95» 

<%= raw t('welcome') 965 
<%= t('hello html') 965 
<%= t('title.html') %> 





eoo http://localhost:3000/ 
<b>welcome!</b> 

welcome! 

hello! 


title! 





这 个 例子 来 自 这 里 
6.4.2.4 显示 Model 属性 


Model.human attribute name(attribute) 


会 显示 我 们 定义 在 语言 包 中 的 属性 名 称 ， 


Model.model name.human 


则 会 显示 该 类 的 名 称 。 为 了 方便 维护 每 一 个 Model » RIE locales 目录 下 ， 为 每 个 Model 
建立 了 自己 的 文件 夹 ， 放 置 单 独 的 语言 包 。 


这 是 我 们 Order 4978 S & > CHE confiy/locales/models/order/zh-CN.yml 


zh-CN: 
activerecord: 
models: 
order: 订单 
attributes: 
order: 
number: 订单 号 


对 于 一 些 属性 ， 可 能 有 两 种 不 同 的 情况 ， 比 如 性 别 : 


en: 
activerecord: 
attributes: 
user/gender: 
female: "Female" 
male: "Male" 


我 们 显示 的 时 候 ， 需 要 这 样 调 用 : 


User.human attribute name("gender.female") 


6.4.3 切换 显示 语言 


RAE config/application.rb 已 经 设置 了 默认 语言 包 ， 但 是 有 些 网 站 需要 在 多 个 语言 包间 切 
换 ， 我 们 已 经 将 语言 包 管理 进行 了 细 分 ， NS ME 个 语言 包 ， 并 且 做 一 个 简单 设 
置 ， 就 可 以 在 这 之 间 切 换 : 


before action :set locale 


def set locale 
I18n.locale = params[:locale] || I18n.default locale 
end 


我 们 可 以 将 选择 的 语言 包 名 称 储存 在 session 中 (虽然 手册 上 步 推荐 这 样 做 ) ， 也 可 以 通过 
地 址 参数 ， 比 如 o1ocalzzh-CN&.... ， 或 者 使 用 routes 来 设 定 地 址 规则 ， 比 如 /zh- 
CN/products/... 来 修改 显示 的 语言 包 。 (手册 推荐 后 两 种 方式 ) 


6.5 生产 环境 部 署 


概要 : 


本 课时 讲解 如 何在 linux 服务 器 上 部 署 Rails 项 目 。 


4n 12 ANNN ; 


rvm 
nginx 
puma 
mina 


NG O FPF WN > 


crontab 
A 
现在 ， 我 们 完成 了 一 个 简单 的 Rails 项 目 ， 我 们 把 它 部 署 到 一 台 linux 服务 器 上 。 


6.5.1 Linux k 3 5 


为 什么 原则 Linux 服务 器 ， 原 因 很 简单 : 方便 。 网 络 上 有 很 多 Rails 部 署 的 文章 和 问题 解答 ， 
我 们 这 里 不 做 资料 大 搜罗 ， 只 讲 讲 部 署 的 思路 。 


Linux 我 们 选择 常用 的 CentOS 或 者 Ubuntu 操作 系统 。 有 一 些 服务 器 会 预制 一 些 软件 ， 比 如 
apache ， (除了 client 还 会 默认 安装 server) ， 这 里 我 选择 一 台 只 安装 了 操作 系统 的 云 
服务 器 。 

6.5.2 SSH 


6.5.2.1 开发 机 器 连接 服务 器 


在 我 们 安装 ， 调 试 和 部 署 环节 中 ， 最 重要 的 工具 是 ssh 。 


SSH 为 Secure Shell 的 缩写 ， 由 IETF 的 网 络 工作 小 组 (Network Working Group) 所 
制定 ; SSH 为 建立 在 应 用 层 和 传输 层 基础 上 的 安全 协议 。SSH 是 目前 较 可 靠 ， 专 为 远程 
登录 会 话 和 其 他 网 络 服务 提供 安全 性 的 协议 。 利 用 SSH 协议 可 以 有 效 防 止 远程 管理 过 程 
中 的 信息 泄露 问题 。SSH 最 初 是 UNIX 系 统 上 的 一 个 程序 ， 后 来 又 迅速 扩展 到 其 他 操作 平 

台 。SSH 在 正确 使 用 时 可 弥补 网 络 中 的 漏洞 。SSH 客 户 端 适用 于 多 种 平台 。 几 乎 所 有 
UNIX 和 平台 一 包括 HP-UX、Linux、AIX、Solaris、Digital UNIX、Irix， 以 及 其 他 平台 ， 都 
可 运行 SSH。 (百度 百科 ) 


我 们 现在 自己 的 开发 机 器 上 ， 创 建 ssh: 


ssh-keygen -t rsa 


这 样 ， 在 -/.ssh/ 目录 下 创建 了 两 个 文件 : id_rsa (4441) 'id rsa.pub (AA) ° AAR 
置 在 我 们 管理 的 服务 器 上 ， 私 钥 是 我 们 连接 服务 器 的 关键 ， 如 果 有 必要 ， 需 要 在 其 他 地 方 做 
一 个 备份 ， 如 果 开 发 机 器 损坏 或 丢失 ， 而 服务 器 又 无 法 连接 的 话 ， 会 造成 巨大 的 损失 和 时 间 
浪费 。 当 然 ， 一 般 云 服务 器 会 提供 应 急 的 web 管理 界面 ， 如 果 出 现 刚才 讲述 的 情形 ， 我 们 重 
新 创建 一 份 私 钥 和 公 铀 ， 并 且 替 换 服务 器 上 的 公 钥 即 可 。 


现在 ， 我 们 在 服务 器 上 创建 一 个 部 署 项 目的 账号 ，deploy : 


useradd deploy 


主意 ， 我 们 登录 这 个 账号 ， 并 且 也 创建 一 份 ssh bak Eo: ， AMT A 7 因为 我 们 的 开发 机 
连接 github，bitbucket 这 种 代码 仓库 ， 它 也 是 要 通过 ssh 连接 的 。 所 以 我 们 连接 的 形 
KA: 


开发 机 器 ---ssh---> 服务 器 -—ssh---» 代码 仓库 


现在 ， 我 们 把 公 负 传递 到 服务 器 上 : 


scp ./ssh/id rsa.pub deploy@domain:/~/.ssh/authorized_keys 


authorized keys 是 公 钥 在 服务 器 上 的 新 名 字 ， 这 个 名 字 可 以 改 掉 。 


为 了 避免 每 次 登陆 服务 器 都 输入 密码 (也 是 防止 密码 被 暴力 破解 ) ， 我 们 配置 下 服务 器 的 
sshd。 这 个 文件 通常 在 /etc/ssh/sshd_config 


AuthorizedKeysFile .ssh/authorized keys [1] 
PermitEmptyPasswords no [2] 
PermitRootLogin no [3] 


PasswordAuthentication no [4] 


[1] 这 是 一 种 适合 多 用 户 的 配置 ， 比 如 ， 多 个 开发 者 登陆 服务 器 ，sshd 会 校 验 每 个 登陆 账户 下 
的 TI ee aes o 


[2] 禁止 空 密码 访问 ， 这 是 默认 的 


[3] 禁止 root 访问 ， 当 我 们 开通 服务 器 时 ， 这 个 选项 默认 是 yes， 这 样 我 们 可 以 使 用 root 登 
陆 。 当 设置 完 ssh 后， 建议 第 一 时 间 关 闭 它 。 


[4] 不 使 用 密码 校 验 ， 这 是 ssh 会 自动 读 取 、 开 发 机 器 上 的 私 铀 校 验 ， 如 果 成 功 匹 配 ， 则 自动 
登陆 服务 器 。 


设置 完 后 ， 重 启 sshd 服务 : 


/etc/init.d/sshd restart 
这 时 ， 我 不 建议 立刻 退出 当前 的 shell， 建 议 新 开 一 个 终端 窗口 进行 登陆 测试 。 


6.5.2.2 服务 器 连接 代码 仓库 


从 服务 器 连接 代码 仓库 ， 比 如 github 或 者 bitbucket， 还 是 国内 的 gitcafe， 原 理 都 是 一 样 ， 需 
要 把 公 包 粘贴 到 账户 的 “SSH Keys" 中， 然后 使 用 命令 行 测试 ， 这 里 给 出 常用 的 测试 命令 


ssh -T gitQgithub.com 
ssh -T git@bitbucket.org 
ssh -T git@gitcafe.com 


如 果 提 示 成 功 ， 说 明 你 可 以 正常 的 使 用 ssh 形式 连接 代码 仓库 了 。 


6.5.3 RVM 


Kun 


在 我 们 第 一 章 的 讲解 中 ， 已 经 在 本 地 安装 了 RVM， 服 务 器 的 安装 是 相同 的 步骤 ， 只 是 要 注定 
的 是 ， 我 们 已 经 使 用 deploy 用 户 安装 了 ssh， 也 用 这 个 账号 来 安装 rvm， 并 且 正 常 运行 
ruby ° 


6.5.4 Nginx 
Nginx 是 目前 应 用 最 广 的 web 服务 器 之 一 。 关 于 linux 的 论述 也 有 很 多 ， 我 们 这 里 只 关注 它 和 
Rails 项 目的 部 署 。 


我 们 下 载 目 前 的 stable 版 本 ，1.8.0， 安 装 之 后 ， 我 们 为 Rails 项 目 建立 一 个 配置 ， 这 个 配置 
通常 放置 在 sites-enabled 中 方便 维护 ， 不 过 要 确保 ， 该 目录 内 的 配置 已 经 加 载 到 nginx 
中 : 


/.../nginx/conf/nginx.conf 


http { 
include ../sites-enabled/*.conf; 


} 


o 


Nginx 和 Rails 的 通信 有 两 种 方式 ，tcp 和 socket。 现 在 我 们 使 用 socket 通信 
为 了 更 多 的 收集 配置 方法 ， 我 在 这 里 建立 了 一 个 代码 仓库 ， 大 家 可 查看 各 种 配置 方式 。 在 这 
里 还 有 其 他 的 一 些 配置 方式 摘要 。 


6.5.5 Puma 


puma * unicorn * passenger 是 常用 的 Rails Server， 这 里 我 们 使 用 puma » 


gem 'puma' 
安装 这 之 后 ， 我 们 有 两 个 命令 ， puma 和 pumactl 。 当 rails s 时 ， 自 动 使 用 的 是 puma 局 


动 ， 为 了 在 服务 器 上 启动 ， 我 们 增加 配置 文件 config/puma.rb ° 


在 服务 器 启动 puma ， 使 用 pumactl 命令 ， 来 进 start/stop/restart 操作 i 


pumactl -F config/puma.rb start/stop/restart 


6.5.6 Mina 


为 了 方便 部 署 新 开发 的 代码 ， 我 们 需要 自动 部 署 工具 ， 常 用 的 是 capistrano 和 mina » KER 
们 使 用 mina 来 部 署 代码 。 


mina 的 代码 在 这 里 。 
KIA mina setup 必 备 的 部 署 目录 ， 以 及 需要 的 public/assets ， log ， tmp 等 目录 。 
然后 只 需 mina deploy 即 可 部 署 最 新 的 代码 。 同 时 ， 在 deploy 中 包装 了 puma 启动 的 命 


|^ 使 用 时 为 mina puma:start/stop/restart ° 


6.5.7 Crontab 


如 果 有 一 些 需 要 定期 执行 的 rake， 或 者 定期 清理 log，tmp“， 过 期 缓存 等 ， 需 要 执行 crontab 
操作 ， 为 了 方便 编写 该 语法 ， 可 以 使 用 whenever o 


wheneverize . 
[add] writing './config/schedule.rb' 


编辑 完 schedule.rb /& * i&ff whenever 查看 结果 ， 并 将 命令 粘贴 到 crontab -e P ° 
说 明 : 


本 章 目的 是 介绍 部 署 思路 ， 如 果 有 部 署 问题 ， 可 以 搜索 到 很 多 解决 方案 ， 而 有 全 ，Ruby China 
社区 有 大 量 经 验 这 是 国内 质量 最 高 的 Ruby 社区， 其 中 有 很 多 经 验 贴 。 


52 3X 
如 果 有 问题 通过 搜索 无 法 解决 ， 可 以 在 Ruby 社区 发 帖 询问 ， 发 帖 时 ， 请 仔细 阅读 Avs o 


6.6 常用 Gem 


概要 : 


本 课时 总 结 本 书 内 提 到 的 常用 的 工具 类 Gemo 
正文 


Devise 
提供 了 用 户 注 册 ， 和 登录， 邮件 确 认 等 众多 实用 功能 。 


https://github.com/plataformatec/devise 


will paginate 


分 页 。 


https://github.com/mislav/will_paginate 


cancan(can) 


权限 管理 。 因 为 Ryan Bates 已 经 两 年 没有 维护 cancan 的 代码 ，Ruby 社区 推出 了 
cancancan ° 


https://github.com/CanCanCommunity/cancancan 


carrierwave 
文件 上 传 。 


https://github.com/carrierwaveuploader/carrierwave 


ransack 


搜索 。 


https://github.com/activerecord-hackery/ransack 


Active Admin 
后 台 管 理 。 


https://github.com/activeadmin/activeadmin 


Simple Form 
方便 易 用 的 表单 。 


https://github.com/plataformatec/simple form 
Paranoia 
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Ihttps://github.com/radar/paranoia 


omniauth 
第 三 方 验证 。 


https://github.com/intridea/omniauth 


settingslogic 
配置 文件 管理 。 


https://github.com/binarylogic/settingslogic/ 
Spree 

开源 的 电 商 程序 。 
https://github.com/spree/spree 

Ruby China 社区 产 码 


开源 的 社区 程序 。 


https://github.com/ruby-china/ruby-china 


写 在 后 面 


2015 年 6 月 29 日 ，0 点 56 分 ， 这 本 《Rails 实践 》 的 第 一 版 总 算 完 成 了 。 从 2 月 11 日 第 一 次 提交 
书稿 内 容 到 今天 ， 总 共用 了 四 个 半月 时 间 。 


2014 年 ， 我 给 自己 的 计划 是 每 天 都 要 写 Rails 代码 ， 后 来 这 个 计划 实现 了 。 


2015 年 ， 我 给 自己 的 目标 是 有 点 成 绩 。 写 书 ， 并 不 是 本 意 ， 本 意 是 整理 自己 阅读 Rails $ 
册 ，API， 各 种 Gem 源码 的 所 感 所 得 。 这 本 书 的 大 纲 来 自 Rails 手册 ， 开 发 年 头 久 的 人 会 经 
常 看 这 个 手册 ， 也 会 经 常 读 源码 和 API， 从 中 解决 一 个 个 问题 ， 但 是 它们 毕竟 不 是 一 个 完整 
的 ， 有 序 的 理解 ， 这 对 于 新 接触 Rails 的 人 会 造成 很 多 困惑 ， 对 于 长 期 开发 Rails 的 人 ， 也 是 
需 用 经 验 把 各 种 问题 串联 起 来 ， 才 能 很 好 的 理解 。 


所 以 ， 这 本 书 ， 是 写 给 我 自己 的 。 对 于 其 他 任何 人 ， 我 不 敢 说 教 ， 这 也 是 自习 室 07 年 开始 时 
候 就 写 过 的 话 。 我 只 是 翻译 ， 整 理 ， 再 加 入 自己 的 理解 。 我 希望 听 到 别人 的 意见 ， 但 是 我 从 
不 以 教学 者 身份 自居 ， 也 不 以 “学 生 "称呼 他 人 。 不 敢当 ， 不 敢当 。 


Ruby China 社区 是 国内 最 好 的 Ruby 社区 ， 这 里 你 可 以 获得 很 多 有 价值 的 分 享 。 
最 后 ， 和 希望 这 本 书 对 你 的 开发 有 点 帮助 。 

里 克 ，2015 年 6 月 29 日 

一 边 看 游泳 世锦 赛 ， 一 边 把 书稿 校对 完了 。 宁 泽 涛 拿 了 亚洲 人 的 第 一 个 100 自 冠军 。 


里 克 ，2015 年 8 月 7 日 


写 在 Ruby China 社区 的 帖子 


向 社区 的 朋友 推荐 自己 的 书 ，《Rails 实践 》 
HEATH HB KERI o 


这 是 第 一 次 写 书 ， 从 2 月 11 日 到 6 月 29 日 ， 总 共用 了 四 个 半月 的 时 间 。 书 中 的 内 容 是 按照 自己 
的 想法 组 织 的 ， 每 个 章节 的 内 容 来 自 对 Rails 手册 的 理解 ，api 的 阅读 体会 ， 以 及 开发 中 的 一 
点 点 心得 。 这 本 书 ， 我 一 直 称 它 为 经 验 的 合 订 本 ， 也 是 写 给 自己 多 年 开发 经 验 的 总 结 。 


我 的 技术 成 长 并 非 一 帆 风 顺 ， 在 写 这 本 书 的 时 间 里 ， 我 不 断 的 回顾 各 种 代码 细节 ， 也 不 断 的 
补充 知识 内 容 。 回 头 看 来 ， 这 对 我 现在 的 项 目 开 发 很 有 益处 。 我 想 ， 一 个 人 的 技术 成 长 有 各 
自 的 方式 ， 四 个 半月 ， 可 以 做 一 个 代码 项 目 ， 也 可 以 写 出 一 本 书 来 ， 从 性 格 上 ， 我 更 适合 后 
者 。 


Ruby China 社区 是 国内 最 好 的 Ruby 开发 社区 ， 这 里 有 大 量 的 经 验 分 享 ， 也 有 一 群 热 心 的 人 
帮助 解决 开发 中 遇 到 的 各 种 问题 。 能 够 从 事 Rails 开发 ， 并 且 身 边 有 一 个 如 此 活跃 、 高 质量 的 
社区 ， 实 在 是 件 幸 运 事 。 它 对 我 的 技术 成 长 有 着 巨大 的 帮助 ， 所 以 ， 这 个 社区 会 一 直 出 现在 

书 的 感谢 列表 中 。 


现在 ， 我 把 这 本 书 正式 的 介绍 给 社区 的 朋友 们 。 之 前 在 社区 里 回复 别人 帖子 的 时 候 ， 贴 过 书 
里 的 连接 ， 那 时 候 ， 我 觉得 书 的 内 容 还 不 是 很 充分 ， 所 以 只 在 自己 微 信 朋友 圈 分 享 过 ， 但 得 
到 的 反馈 还 是 有 限 的 ， 作 为 一 个 写作 上 的 新 手 ， 还 是 很 期 望 得 到 别人 更 多 的 反馈 。 所 以 这 次 
正式 贴 出 来 ， 希 望 朋友 们 不 吝 赐 教 ， 督 促 我 改进 和 提高 书 中 内 容 。 


再 次 ， 感 谢 社区 的 朋友 们 。 
阅读 地 址 : http://rails-practice.com/content/ 


注 : 书 的 网 页 版 和 电子 版 都 是 免费 的 ， 不 会 出 现任 何 形 式 的 付费 下 载 。 


